Class 'Yii' not found 报错需三步解决：先确认 web/index.php 正确引入 vendor/autoload.php；再检查 mbstring、intl、openssl 扩展是否启用；最后验证 Web 服务器配置中路径变量（如 $realpath_root）是否正确。
Class 'Yii' not found 报错怎么解决
执行 php yii migrate 或访问首页时提示 Class 'Yii' not found，本质是自动加载机制失效，不是框架没装好。
第一步：确认 vendor/autoload.php 是否被正确引入——打开 web/index.php，检查开头三行是否为：
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');
require __DIR__ . '/../vendor/autoload.php';
第二步：运行 php -m | findstr "mbstring intl openssl"，缺任一模块都会导致 autoload.php 初始化失败，PHP 8.2+ 下 intl 扩展缺失会直接中断类加载流程。
第三步：若使用 Apache，检查 .htaccess 是否被禁用；若用 Nginx，确认 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; 中的 $realpath_root 指向项目根目录，【写成 $document_root 将导致 vendor/autoload.php 路径解析错误】。
前端 JS 组件 404（如 jquery.inputmask）
页面加载时报 jquery.inputmask.js 404，控制台 Network 标签页显示 bower-asset/jquery.inputmask/dist/inputmask.js 返回 404，这是 Yii2 2.0.48 默认跳过 bower 资源安装导致的。
方法一：手动补全 bower-asset 目录
下载 https://github.com/yiisoft/yii2/releases/download/2.0.48/yii-advanced-app-2.0.48.tgz → 解压 → 进入 vendor/bower-asset → 全量拷贝该文件夹覆盖你项目中的 vendor/bower-asset。
方法二：启用兼容性插件（仅限开发环境）
执行 composer require yidas/yii2-composer-bower-skip:~2.0.5 → 在 composer.json 的 config 块中添加 "fxp-asset": {"enabled": false} → 再运行 composer update yiisoft/yii2 --with-all-dependencies。
注意：方法二在 PHP 8.5 环境下不可用，会触发 fxp 插件与 Composer 2.5.8 的兼容性中断，必须用方法一。
500 错误但页面空白无报错信息
Windows 或 Linux 下访问首页只返回空白 500 页面，真实错误被静默吞掉，无法定位问题根源。
第一步：强制开启 PHP 错误显示
在 web/index.php 开头插入两行：
error_reporting(E_ALL);
ini_set('display_errors', '1');
第二步：确认 YII_DEBUG 已启用
检查 web/index.php 中 defined('YII_DEBUG') or define('YII_DEBUG', true); 是否存在且未被注释；若为 false，所有异常将被 ErrorHandler 拦截并转为白屏。
第三步：查 Web 服务器原生日志
Apache 查 logs/error.log；Nginx 查 error_log 配置指向的文件；IIS 在管理器中启用“详细错误”并刷新页面——【90% 的空白 500 实际是 PHP 扩展未加载或 runtime 目录不可写，而非代码异常】。
php yii migrate 报错 Class 'yii\console\Application' not found
在项目根目录执行 php yii migrate 提示 Class 'yii\console\Application' not found，说明 console 入口未正确定义或命名空间错位。
检查 console/yii 文件首行是否为 #!/usr/bin/env php，第二行是否为
确认 console/config/main.php 中 'bootstrap' => ['log'] 和 'components' => ['log' => [...]] 完整存在，缺 log 组件会导致 Application 类初始化失败。
若项目为高级模板，确保 console/yii 中的 $config = require __DIR__ . '/config/main.php'; 指向的是 console/config/main.php，而不是 web/config/main.php —— 【路径写错会导致自动加载找不到 yii\console\Application】。
POST 请求返回 500 且日志显示 CSRF token mismatch
表单提交或 API 调用时偶发 500，日志里出现 “Unable to verify your data submission” 或 “CSRF token mismatch”，这不是网络问题，而是 Yii2 的 CSRF 验证机制拦截了合法请求。
方法一：API 接口关闭 CSRF 验证（推荐）
在控制器 action 前加 public function init() { parent::init(); \Yii::$app->request->enableCsrfValidation = false; }。
方法二：前端带 CSRF token 提交
在表单中加入 = Html::hiddenInput(Yii::$app->request->csrfParam, Yii::$app->request->getCsrfToken()) ?>；
若用 axios，需在请求头加 headers: { 'X-CSRF-Token': '= Yii::$app->request->getCsrfToken() ?>' }。
方法三：全局禁用（仅限调试）
在 config/web.php 的 request 组件配置中加 'enableCsrfValidation' => false —— 但上线前必须移除，否则存在安全风险。
