常见问题解决方案
部署过程中遇到问题？这里整理了常见问题及解决方法。
1. 访问网站显示 500 错误
可能原因：
- PHP版本不正确，请确保使用 PHP 8.1
- 缺少必要扩展（Redis、fileinfo、SG17）
- 目录权限不足
解决方法： 检查PHP版本和扩展，执行 chmod -R 777 设置目录权限。
2. 伪静态不生效 / 页面404
可能原因：
- 伪静态规则未正确配置
- 运行目录未设置为
public
解决方法： 检查Nginx/Apache伪静态配置，确保运行目录设置正确。
3. Redis 连接失败
可能原因：
- Redis服务未启动
- Redis密码配置错误
- PHP未安装Redis扩展
解决方法： 启动Redis服务，检查配置文件中的Redis连接信息。
4. SG17 扩展加载失败
可能原因：
- 扩展版本与PHP版本不匹配
- php.ini 配置路径错误
解决方法： 下载对应PHP 8.1版本的SG17扩展，确保在php.ini中正确配置扩展路径。
5. 数据库连接失败
可能原因：
- 数据库账号密码错误
- 数据库服务未启动
- 数据库用户权限不足
解决方法： 检查数据库配置信息，确保数据库服务正常运行且用户有足够权限。
6. 安装页面样式丢失
可能原因：
- 静态资源路径错误
- CDN或防火墙拦截了静态资源
解决方法： 检查网站根目录结构，确保静态资源文件完整上传。
7. 用户登录或后台登录被拦截提示网络错误
可能原因：
- 宝塔面板的Nginx防火墙拦截了登录请求
- Nginx防火墙中的弱密码保护功能误判
解决方法： 进入宝塔面板 → 应用商店 → Nginx防火墙，关闭"弱密码保护"功能。
8. 页面提示"十年磨一剑"
排查方法： 开启debug模式查看具体错误原因。
常见原因：
- 如果提示
permission denied，说明目录权限不足 - 如果提示
SQLSTATE HY000，说明数据库连接配置错误
解决方法：
- 权限问题：给站点文件夹设置777权限
chmod -R 777 /www/wwwroot/your-domain/ - 数据库问题：修改
config/database.php中的数据库连接配置
9. 安装时提示网络连接错误
可能原因：
- 数据库连接信息填写错误
- 数据库不是空的（已有数据表）
- 站点目录没有777权限
解决方法：
- 检查数据库账号、密码、主机地址是否正确
- 使用空数据库进行安装，或清空现有数据库
- 给站点文件夹设置777权限
chmod -R 777 /www/wwwroot/your-domain/