ThinkPHP接口调试完整教程-ThinkPHP-PHP中文网

thinkphp接口返回500但前端看不到错误详情，根本原因是app_debug未在入口文件最顶部正确定义、php错误显示未开启、日志未启用或权限不足、json响应未统一处理，需逐层排查。

thinkphp接口调试完整教程

ThinkPHP接口返回500但前端看不到错误详情？不是框架“没报错”，而是错误被吞了、没露出来、或根本没写进日志——得一层层拆开看。

ThinkPHP在加载框架前就检查APP_DEBUG，一旦错过时机，后面改config、改.env、甚至控制器里define()都无效。它不认“后来才设”的值。

✅ 正确位置：打开public/index.php，在第一行（任何require之前）直接写define('APP_DEBUG', true);
❌ 错误操作：在config/app.php里改'app_debug' => true，或把APP_DEBUG=true只写在.env里——.env只是后备，会被代码中define()覆盖
⚠️ 多入口注意：CLI命令（如php think run）、多模块入口、Swoole子进程等，每个启动点都要单独加define('APP_DEBUG', true)
验证是否生效：var_dump(defined('APP_DEBUG') && APP_DEBUG);输出bool(true)才算成功

即使APP_DEBUG = true，如果PHP自身禁用错误输出，ThinkPHP会主动放弃渲染错误页，直接返回500——这是它的保护逻辑，不是bug。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

运行php -i | grep -E "display_errors|error_reporting"，确认display_errors为On，且error_reporting数值≥32767（即E_ALL）
临时绕过检查：在public/index.php顶部define('APP_DEBUG', true)后立刻加两行：ini_set('display_errors', '1');和error_reporting(E_ALL);
Windows下路径含中文（比如项目在C:\用户\xxx\project）可能触发Malformed UTF-8错误，该错误在JSON响应阶段被静默捕获，导致空白500；换成纯英文路径测试

你看到带堆栈的网页，而不是{"code":500,"msg":""}？因为render()默认按Accept头或URL后缀判断格式，没明确声明JSON时就fallback到HTML。

别只依赖$request->isAjax()：现代fetch请求不带X-Requested-With头，isAjax()会返回false
优先用$request->expectsJson()，再兜底检查路由前缀：$request->routeIs('api.*')或str_starts_with($request->path(), 'api/')
在app/exception/Handler.php的render()方法中，统一用response()->json(['code' => 500, 'msg' => $e->getMessage()], 500)返回，避免直接return json(...)跳过中间件和状态码
线上环境务必关掉show_error_msg：检查config/app.php中'show_error_msg' => false是否生效，否则即使APP_DEBUG=false，SQL和路径仍可能泄露

runtime/log为空，大概率不是配置写错了，而是日志根本没写进去。

ThinkPHP默认只在LOG_RECORD => true时记录异常堆栈，而生产配置常默认关掉它；检查config/app.php中log配置，确保显式启用：'record' => true，且'level' => ['error', 'sql']
执行ls -ld runtime/ runtime/log/，确认Web进程用户（如www-data、nginx）对这两个目录有写权限；必要时运行：chown -R www-data:www-data runtime/
若用Swoole或Worker模式，LOG_PATH可能指向/tmp/think-log等独立路径，需单独检查该路径是否存在、可写
数据库连不上却只报500？APP_DEBUG = false时PDO异常被框架捕获并抹掉原始信息；临时在app/common.php开头加ini_set('display_errors','1'); error_reporting(E_ALL);，让异常浮出水面