根本原因是错误被静默吞掉或响应格式错乱，尤其在AJAX/API场景下500响应体为空、HTML或JSON混杂；并发放大了调试关闭、errorHandler渲染异常、权限争抢、连接池耗尽等问题。
Yii2并发请求报错不显示提示，根本原因不是并发本身，而是错误被静默吞掉或响应格式错乱——尤其在 AJAX、API 或高频率表单提交场景下，500 响应体可能是空白、HTML 页面、甚至 JSON 里混着 <div> 标签。
<h3>为什么并发时错误更难看到</h3>
<p>并发请求会放大环境配置缺陷：调试开关未开、<code>display_errors 关闭、errorHandler 仍按 HTML 渲染、CSRF 验证失败被拦截在中间件层。更麻烦的是，多个请求争抢 runtime/ 目录写权限或数据库连接池耗尽，导致报错发生在应用启动前，连 Yii 的 errorAction 都没机会触发。
- 浏览器开发者工具 Network 面板看到
500，但 Response 是空或一堆 HTML 源码 -
var_dump($_FILES)在并发上传中偶尔为空——不是代码问题，是 CSRF token 被复用或过期 - 同一接口单次调用正常，10 个
fetch()并发就集体挂掉，日志里只有PHP Warning: mkdir(): Permission denied
让并发错误立刻浮出水面
别等用户反馈，先确保你能在本地复现并看清真实异常：
- 打开
web/index.php，确认这两行在最顶部且未被注释：defined('YII_DEBUG') or define('YII_DEBUG', true);和defined('YII_ENV') or define('YII_ENV', 'dev'); - 紧接其后加两行强制暴露：
error_reporting(E_ALL);和ini_set('display_errors', '1'); - 检查
php.ini中log_errors = On且error_log指向可写路径，避免错误只打屏不落盘 - 对 API 接口，在控制器
beforeAction()中加判断：if (Yii::$app->request->getIsJson()) { Yii::$app->response->format = \yii\web\Response::FORMAT_JSON; }，防止 HTML 错误页污染响应
并发场景下必须检查的三处权限与状态
并发放大资源竞争，以下检查点比单请求更关键：
-
runtime/和web/assets/目录权限必须为755（Linux）或对 IIS_IUSRS/Apache 用户有“修改”权限（Windows），否则多请求同时写缓存会直接500 - 数据库连接数是否爆满：查
show status like 'Threads_connected';，并在config/db.php中显式设'attributes' => [\PDO::ATTR_PERSISTENT => false]避免长连接堆积 - CSRF token 是否被复用：AJAX 并发请求若共用同一个
_csrf值，第二个起就会因 token 失效返回400；改用Yii::$app->request->getCsrfToken()每次动态取，或在ActiveForm中禁用：'enableClientValidation' => false, 'validateOnSubmit' => false
API 并发错误必须返回结构化 JSON
默认 yii\web\ErrorHandler 对所有请求都渲染 HTML，这是并发 AJAX 场景下最常踩的坑。不要试图 patch 视图，直接接管错误流：
- 在
config/web.php的components中重定义：'errorHandler' => ['class' => 'yii\web\ErrorHandler', 'errorAction' => 'api/error'] - 新建
controllers/ApiController.php，实现actionError()，开头加判断：if (!Yii::$app->request->getIsJson()) { throw new \yii\web\NotFoundHttpException(); } - 返回数组而非 echo：
return ['code' => $exception->getCode() ?: 50000, 'message' => $exception->getMessage()];—— Yii2 会自动序列化为 JSON，且状态码由$exception->statusCode决定 - 特别注意：别在
actionError里再抛异常，否则死循环；也别依赖Response::FORMAT_JSON全局设置，它不干预错误分支
真正棘手的并发错误往往卡在 PHP-FPM 进程模型或 Web 服务器连接限制上，比如 Apache 的 MaxRequestWorkers 设太低，或 Nginx 的 proxy_buffering off 缺失导致响应截断——这些已超出 Yii2 层面，得看 error_log 里有没有 upstream prematurely closed connection 这类线索。
