后端无法启动
- 查看启动日志中的异常堆栈。
- 检查 MySQL 是否可连接。
- 确认配置项完整、密钥已设置。
- 确认端口
8090未被占用。
前端页面空白或接口 404
- 确认后端已启动。
- 检查
.env.production的VITE_API_URL。 - 检查 Nginx 反向代理与路由回退配置。
登录状态异常
- 检查数据库连接与
cache_entry缓存表是否正常。 - 确认
token.secretKey一致且未变更。 - 清除浏览器本地存储后重试。
内容未更新
- 确认数据库数据已更新。
- 清理缓存后刷新页面。
- 检查浏览器与 CDN 缓存。
图片上传失败
- 检查图床配置与凭据。
- 检查本地上传目录权限与磁盘空间。
- 查看后端日志中的上传异常。