ThinkPHP Linux故障怎么排查 - 问答

ThinkPHP Linux 故障排查清单

一快速定位与通用检查

查看 Web 服务器错误日志（Nginx：/var/log/nginx/error.log；Apache：/var/log/apache2/error.log 或 error_log），优先从最后几行定位 500/404/Permission denied 等关键信息。
打开 应用调试模式：在 .env 或 config/app.php 将 app_debug=true，刷新页面获取详细堆栈；上线务必关闭。
核对 PHP 版本与扩展：确保符合所用 ThinkPHP 版本要求（如 TP6 需 PHP 7.2+），并启用 PDO、MBstring、CURL、OpenSSL 等扩展。
检查 磁盘与资源：执行 df -h 看磁盘是否满；必要时调整 PHP 内存限制 memory_limit 与 最大执行时间 max_execution_time。
如修改了代码或配置，先执行 php think clear 清理缓存，避免旧缓存导致异常。

二常见症状与对应处理

症状	高频原因	快速修复
500 Internal Server Error	语法/逻辑错误、权限不足、PHP 配置过低	查 Nginx/Apache 错误日志；开启 app_debug 看详细报错；检查 runtime 可写；适当调高 memory_limit、max_execution_time
页面空白或路由 404	URL 重写未生效	Apache 开启 mod_rewrite 且 AllowOverride All；Nginx 配置将请求转发到 public/index.php
Fatal error: require(): Failed opening required	路径错误、文件缺失、大小写问题、open_basedir 限制、Composer 未安装依赖	用 DIR 修正入口包含路径；核对文件是否存在且大小写一致；检查 open_basedir；执行 composer install 生成 vendor/autoload.php
数据库连不上	账号/密码/库名错误、远程访问未授权、服务未启动	核对 config/database.php；命令行测试 mysql -u 用户名 -p；确认数据库允许当前主机连接并放行防火墙
Permission denied / runtime 不可写	runtime 目录权限或属主错误	设置 runtime 755 并由 Web 服务用户（如 www-data）拥有；避免全站 777
Class ‘xxx’ not found	命名空间/类名大小写错误、未执行 composer dump-autoload	修正命名与大小写；执行 composer dump-autoload 重建自动加载索引

三关键目录与权限配置

确保 runtime（含 cache、log、temp 等子目录）可写：建议设置 755 并通过 chown 将所有者设为 Web 服务运行用户（如 www-data），避免 777 带来的安全风险。
入口文件 public/index.php 建议使用绝对路径引入：如 require DIR.‘/…/vendor/autoload.php’;（TP5+ 使用 Composer 时），避免因工作目录不同导致包含失败。
部署后若仅修改了代码，执行 php think clear 清理缓存，防止旧缓存引发异常。

四 Web 服务器与伪静态配置要点

Apache：启用 mod_rewrite；将项目根目录（或 public）的 AllowOverride 设为 All；确保 .htaccess 包含框架推荐的重写规则。
Nginx：在 server 配置中对 location / 做转发，示例：
- 将 root 指向项目 public 目录；
- 使用 try_files $uri $uri/ /index.php?$query_string; 将所有非静态资源请求转发到 index.php；
- 保存后重启 Nginx/php-fpm 使配置生效。

五一键排查命令清单

查看版本与扩展：
- php -v
- php -m | grep -E ‘pdo_mysql|mbstring|curl|openssl’
语法快速检查：
- find app -name “*.php” -exec php -l {} ;
依赖与自动加载：
- composer install
- composer dump-autoload
日志与资源：
- tail -n50 /var/log/nginx/error.log
- tail -n50 /var/log/apache2/error.log
- df -h
权限与属主：
- ls -ld runtime
- chmod -R 755 runtime
- chown -R www-data:www-data runtime
缓存与配置：
- php think clear
- 在 .env 或 config/app.php 中临时设置 app_debug=true 复现问题后记得关闭

0 赞

0 踩