部署相关问题

安装页面打不开

现象：访问域名后显示空白或报错。

排查步骤：

1. 确认站点根目录指向 public/ 文件夹
2. 确认 PHP 版本为 8.0+
3. 检查 runtime/ 目录是否有写权限

安装时数据库连接失败

现象：填写数据库信息后提示连接失败。

排查步骤：

1. 确认 MySQL 服务已启动
2. 检查数据库地址、端口、用户名、密码是否正确
3. 确认 MySQL 用户有创建数据库的权限
4. 如果是远程数据库，确认防火墙已放行 3306 端口

页面显示 404

现象：首页正常，但点击其他页面显示 404。

原因：伪静态（URL 重写）未配置。

解决：

• Nginx：参考 Nginx 部署 添加伪静态配置
• Apache：确认 mod_rewrite 已启用，public/.htaccess 文件存在
• 宝塔：参考 宝塔面板 配置伪静态

登录后提示"未授权"

现象：输入正确的账号密码后，进入系统提示"未授权"或自动跳回登录页。

原因：JWT Token 的 Authorization 头未传递到 PHP。

解决：

• Nginx：在 PHP 配置中添加 fastcgi_param HTTP_AUTHORIZATION $http_authorization;
• Apache：通常无需额外配置，检查 .htaccess 是否被覆盖

静态资源加载失败

现象：页面样式错乱，JS/CSS 文件 404。

排查步骤：

1. 确认 public/assets/ 目录存在且有文件
2. 如果为空，需要重新构建前端：cd web && npm run build
3. 检查浏览器控制台的具体报错路径

更多帮助

• 环境要求 → 确认服务器配置
• Nginx 部署 → Nginx 配置参考
• Apache 部署 → Apache 配置参考
• 宝塔面板 → 宝塔部署参考
• 使用问题 FAQ → 功能使用相关问题