class not found 错误本质是类加载路径或结构不匹配，yii2 因安装方式、命名空间、自动加载、web 路径、服务注册等问题引发；yii3 则因 psr-4 依赖增强、命名空间强制 yiisoft\、di 容器默认启用及无模板项目导致差异。
Class not found 是 Yii2.0 最高频的报错，本质不是框架坏了，而是类加载路径或结构没对上。Yii3 虽然底层更规范，但同样会出这类错——只是触发场景和修复逻辑略有不同。
Yii2.0 的 Class not found 主要原因
不是代码写错了，而是环境或配置没到位：
-
用错安装方式：执行
composer require yiisoft/yii2只装了内核，缺 web/index.php、config/、yii 命令等骨架文件；必须用composer create-project yiisoft/yii2-app-basic（或 advanced）启动项目 -
命名空间漏写或写错：比如控制器里写
use yii\base\Controller;，实际应为use yii\base\Controller;（这个没错），但常见错误是漏掉yiisoft\前缀——不过 Yii2 本身不带yiisoft\，它是yii\；真正容易错的是扩展类或自定义类，比如支付宝 SDK 文件没统一加namespace app\components\alipay; -
自动加载没生效：web/index.php 开头没引入
require __DIR__ . '/../vendor/autoload.php';；或自定义类没放在 PSR-4 规范路径（如@app/components/），也没在composer.json里配 autoload -
Web 服务器路径不对：Apache/Nginx 的 document root 指向项目根目录，而不是
web/子目录，导致vendor/autoload.php找不到 -
服务未注册就调用：比如在 config 中没配
'myService' => ['class' => MyService::class]，却直接写Yii::$app->get('myService')，会报 Class not found 或 “not registered”
Yii3 的 Class not found 差在哪
Yii3 用纯 PSR-4 + Composer 自动加载，不再依赖 Yii::$app 预加载机制，所以表现更“直白”，但也更依赖配置：
-
没有“模板项目”概念：Yii3 不再提供
yii3-app-basic这类开箱即用包，所有结构（包括入口、配置、命令）都得自己搭或选第三方 starter kit；漏一个config/web.php或public/index.php就直接 Class not found -
命名空间强制 yiisoft\：Yii3 所有核心类都是
yiisoft\yii-web\Application这种形式，照搬 Yii2 的yii\web\Application写法必然报错 -
DI 容器默认启用：构造函数依赖自动解析是默认行为，但如果类型提示的接口没绑定实现（比如
MailerInterface没$container->set(MailerInterface::class, PhpMailer::class)），就会报 Class not found，而非 Yii2 那种“服务未注册”提示 -
不再兼容 Yii2 的组件注册方式：Yii3 没有
Yii::$app->set()这种全局注册，所有服务都走 DI 容器；把 Yii2 的 components 配置直接挪过去，Yii::$app->db会直接炸
快速排查三步法（2.0 和 3.0 都适用）
别猜，按顺序查：
-
看报错里的类名全称：是
yii\web\Application？还是app\services\OrderService？前者说明框架结构缺失，后者说明你自己的类没被加载 -
确认类文件是否存在且路径匹配命名空间：比如报
app\components\AlipayTradeService找不到，就去检查src/components/AlipayTradeService.php（Yii3）或@app/components/AlipayTradeService.php（Yii2），并确认文件里写了对应 namespace -
运行 composer dump-autoload -o：尤其改过 autoload 配置或新增类后，强制刷新映射；Yii3 还建议加
--classmap-authoritative提升性能和稳定性
不复杂但容易忽略。
