Yii RESTful接口返回500且无错误详情，大概率因errorHandler未启用、request组件缺失cookieValidationKey或PHP致命错误未进入Yii日志，需检查调试模式、错误处理配置、Cookie密钥及Web服务器错误日志。
Yii RESTful 接口返回 500，大概率不是业务逻辑出错，而是底层配置或环境没对上——尤其是 errorHandler、request 和 PHP 错误处理这三块没配好，直接让异常掉进 Apache/Nginx 的“黑洞”里，连日志都不留。
为什么 REST 接口 500 却看不到错误详情
Yii 的 REST 模块（yii\rest\ActiveController 等）默认不渲染 HTML 错误页，它依赖 errorHandler 统一格式化响应。一旦 errorHandler 本身挂了、没启用，或被中间件/路由提前拦截，PHP 原始错误就会触发 500，且不输出任何信息。
- 检查入口文件
web/index.php是否设置了YII_DEBUG = true和YII_ENV = 'dev'；否则生产模式下会静默吞掉大部分异常 - 确认
config/web.php中'errorHandler' => ['errorAction' => 'site/error']已配置，且SiteController::actionError()存在并能正常返回 JSON（REST 场景下建议用yii\web\ErrorAction而非自定义 action） - 如果用了 Nginx，确认没有
fastcgi_intercept_errors on这类配置把 4xx/5xx 响应直接替换成自定义错误页，导致 Yii 的错误响应被截断
yii\web\Request::cookieValidationKey 报错引发 500
这是最常被忽略的“隐形炸弹”。只要接口涉及 session、CSRF 验证、Cookie 解析（哪怕只是读取），而 request 组件没配 cookieValidationKey，Yii 就会在初始化阶段抛出未捕获异常，直接 500。
- 打开
config/web.php，在'components' => ['request' => [...]]里补上：'cookieValidationKey' => '随便一串32位以上随机字符串' - 别用空字符串或
null，Yii 会严格校验长度；也别用硬编码的固定值（如'test'），上线前务必换掉 - 如果项目用了多台服务器部署，这个 key 必须完全一致，否则跨机器的 Cookie 无法验证
PHP 错误没进 Yii 日志，只看到空白 500
说明 PHP 层面的致命错误（如 Parse Error、Fatal Error）压根没走到 Yii 的 ErrorHandler，而是被 Web 服务器直接拦截了。
- 查 Apache 的
error_log（路径类似/usr/local/apache/logs/error_log）或 Nginx 的error.log，用tail -f实时观察请求时的原始报错 - 常见真实错误包括：
SoftException in Application.cpp:256: File "/web/index.php" is writeable by group（文件权限问题，把index.php权限从664改成644） - 检查是否加载了必要扩展：REST 接口依赖
json、mbstring，部分数据库操作还依赖pdo_mysql或pgsql；用php -m | grep -E 'json|mbstring|pdo'快速验证
调试时 errorAction 不生效，始终返回白屏
根本原因往往是控制器动作没按 REST 规范返回正确格式，或者响应头被污染。
-
SiteController::actionError()内必须显式设置响应格式：Yii::$app->response->format = \yii\web\Response::FORMAT_JSON; - 确保该 action 没有调用
$this->render()（那是 HTML 渲染），而是直接return ['message' => $exception->getMessage(), 'code' => $exception->getCode()] - 检查是否在
beforeAction()或行为（Behavior）里提前终止了请求，比如某个鉴权行为抛出ForbiddenHttpException后没被errorHandler捕获，就容易漏掉
真正卡住的地方往往不在接口代码里，而在 config/web.php 的组件初始化顺序、Web 服务器的权限控制、以及 PHP 扩展是否完整加载——这些地方一动不动，光改 Controller 是没用的。
