yii2不直接报目录路径错误，是因为yii_debug=false或非dev环境下异常处理机制会屏蔽底层php错误（如mkdir()失败、open_basedir限制），转而记录日志并返回通用500；需同时满足yii_debug=true、yii_env='dev'及php error_reporting(e_all)且display_errors=1，错误才原样输出。
Yii2 报“目录不存在”这类错误（比如 assets 目录缺失、runtime 不可写、vendor 未安装）时，默认往往不直接显示完整路径和原因，而是抛出白屏或 500，甚至被 ErrorHandler 拦截成友好的错误页——这反而掩盖了真实问题。
为什么 Yii2 不直接报出目录路径错误
根本原因是：Yii2 的异常处理机制在 YII_DEBUG = false 或非 dev 环境下会主动屏蔽底层 PHP 错误（如 is_dir() 失败、mkdir() 权限拒绝），转而记录到日志并返回通用 HTTP 状态。你看到的“页面空白”或“Internal Server Error”，背后可能是 mkdir(): Permission denied 或 file_exists(): open_basedir restriction 这类明确提示，但被吞掉了。
强制让“目录不存在”错误浮出来
必须同时满足三个条件，错误才能原样输出到浏览器：
-
defined('YII_DEBUG') or define('YII_DEBUG', true);在web/index.php顶部已启用（不能注释、不能为false） -
defined('YII_ENV') or define('YII_ENV', 'dev');同样在index.php中设置（仅'dev'环境才允许显示详细堆栈） - PHP 层面错误显示打开：
error_reporting(E_ALL); ini_set('display_errors', '1');放在index.php最开头（比require __DIR__ . '/../vendor/autoload.php';还要早）
做完这三步再刷新，如果真是目录问题（例如 runtime 不存在），你会看到类似这样的致命错误：
PHP Fatal error: Uncaught yii\base\InvalidConfigException: The directory does not exist: /var/www/html/basic/runtime in /var/www/html/basic/vendor/yiisoft/yii2/BaseYii.php:492
常见“目录不存在”错误对应的真实位置
不同报错信息指向不同目录，别只盯着字面：
-
The file or directory to be published does not exist: .../gii/assets→ 实际是web/assets/目录缺失或不可写，不是gii包路径错了 -
Unable to create the directory: /path/to/runtime/cache→runtime/存在但子目录（如cache、logs）没权限创建，本质仍是runtime所在父目录对 Web 用户无写权限 -
Failed to write file to disk（上传失败时）→ 很可能web/assets/或runtime/不可写，而非临时目录/tmp问题 -
Class 'yii\gii\Module' not found→ 表面是类找不到，实则是vendor/没装全或autoload没生效，先跑composer install
检查目录是否存在且可用的最快命令
别靠猜，进服务器终端直接验证：
- 确认
web/assets和runtime目录存在且属组正确：ls -ld web/assets runtime - 测试 Web 用户能否写入：
sudo -u www-data touch runtime/test && echo "OK" || echo "FAIL"（把www-data换成你服务器真实用户） - 看最近日志里有没有权限相关报错：
tail -n 20 runtime/logs/app.log | grep -i "permission\|mkdir\|dir"
真正卡住的从来不是“目录该不该存在”，而是“Web 进程有没有权限进去建它”。只要 display_errors 开了、YII_DEBUG 开了、YII_ENV 是 dev，错误一定出得来——出不来，说明这三件事至少有一件没做对。
