打不开、登录失败与图片异常排查

网站或后台打不开

先检查 MySQL、Redis 是否启动，再检查 API、官网和 Worker。Docker 承载数据库时先确认 Docker 正在运行；仅看到 Node.js 端口监听不代表数据库可用。

curl -f http://127.0.0.1:3004/api/v1/health
curl -f http://127.0.0.1:3003/
curl -f http://127.0.0.1:3010/health

后台空白或资源 404

核对 apps/admin/dist 是否完整、VITE_BASE_URL 是否为 /admin/、Nginx alias 是否指向当前目录。后台重建后旧标签页可能请求旧文件，刷新页面再检查。不要将前台正常误判为后台也已部署。

登录失败或 CSRF 错误

检查实际 HTTPS 域名与 PUBLIC_SITE_URL、CORS_ORIGINS 是否一致，Nginx 是否转发 X-Forwarded-Proto。/api/session/ 与前台 /api/v1/ 应通过 Nuxt；不能通过关闭 CSRF 解决。

数据库 P1001 或认证错误

核对 MySQL 服务、实际端口、账号访问范围以及密码 URL 编码。API 健康路由返回 ok 也需要进一步验证数据库相关页面。

图片不显示

核对 PUBLIC_SITE_URL、公开图片路径、/uploads/ 代理和媒体是否公开。私有源码包不能作为公开图片目录暴露。

构建内存不足或版本错误

核对 Node.js 24、pnpm 11.1.3、磁盘与内存。停止重复并发构建；不要直接复制另一台 Windows 机器的依赖和 Prisma 引擎。

提交问题前

附上源码版本、运行环境、复现步骤和脱敏错误片段。不要上传 .env、完整授权码、Cookie、数据库密码或用户数据。可以通过本站社区说明问题，或带着当前章节向 AI 助手提问。