升级 pbootCMS 后首页出现 500 错误，通常是缓存未清理、文件权限不足或代码语法冲突导致。优先通过开启调试模式定位具体报错，再结合运行时日志排查。
先说结论：大多数情况是运行时目录权限不足或模板缓存冲突，建议先开启调试模式查看具体错误信息，排查后务必关闭。
- 先确认：检查服务器错误日志和 CMS 运行时日志，确认 Web 服务器运行用户
- 先处理：清理缓存并修正 runtime 目录权限，注意不要误删目录本身
- 再验证：刷新首页确认状态码恢复 200，并关闭调试模式
快速处理思路
如果没有立即执行命令的权限，按以下顺序操作：
- 临时开启调试模式显示具体错误（用完即关）
- 查看
runtime/log下的最新日志文件 - 删除
runtime目录下的缓存文件（保留目录）
分步处理
第一步：开启调试模式
在站点根目录的 config/config.php 中，找到 debug 配置项，将其设置为 true。若该文件无此配置项，部分版本需在 index.php 或核心启动文件中定义 DEBUG 常量。这样页面会显示具体的 PHP 错误信息，而不是通用的 500 提示。注意：生产环境排查完毕后必须改回 false 或注释掉，防止敏感信息泄露。
第二步：检查日志文件
进入服务器命令行，查看运行时日志。默认路径通常在 runtime/log/ 目录下。使用以下命令查看最新日志：
tail -n 50 runtime/log/*.log同时检查 Web 服务器日志，Nginx 通常在 /var/log/nginx/error.log，Apache 在 /var/log/httpd/error_log。
第三步：确认用户与修正权限
不同 Linux 发行版 Web 服务器运行用户不同（如 Ubuntu 为 www-data，CentOS 可能为 nginx 或 apache）。先执行以下命令确认当前运行用户：
ps aux | grep -E 'php-fpm|nginx|httpd' | grep -v grep确认用户后，确保 runtime 目录及其子目录有写入权限。执行以下命令（将“用户：用户组”替换为实际查到的用户）：
chmod -R 755 runtime
chown -R 用户：用户组 runtime然后删除 runtime 目录下的所有文件，不要删除目录本身，让系统重新生成缓存。建议使用以下命令安全清理：
find runtime -type f -delete
find runtime -type d -empty -delete怎么验证是否生效
使用 curl 命令测试首页状态码：
curl -I http://你的域名.com如果返回 HTTP/1.1 200 OK，说明问题已解决。同时观察日志文件不再新增错误记录。
常见坑
1. 生产环境忘记关闭调试模式，导致页面暴露敏感路径信息。
2. 直接给 runtime 目录设置 777 权限，存在安全风险，建议根据 Web 服务器用户设置归属。
3. 升级后未执行数据库更新脚本，导致代码与数据库结构不匹配。
4. 使用 rm -rf runtime 误删了整个目录，导致站点无法写入日志，需重新创建并授权。