“View file does not exist”错误直接表明视图路径错位，Yii2严格按顺序查找：控制器viewPath（如@app/views/product/）→模块viewPath→@app/views/根目录；跨目录渲染须用完整别名路径（如@app/views/user/profile），不可依赖相对路径或模糊匹配。
View file does not exist 错误直接对应路径错位
Yii2 报 InvalidParamException 提示 “View file does not exist”，基本等于你写的视图名和实际文件路径对不上。它不会模糊匹配，也不会自动 fallback 到其他目录——查不到就抛异常，不猜、不试、不妥协。
常见触发点：
- 在
SiteController里写$this->render('user/profile')，但文件实际在@app/views/user/profile.php；而SiteController默认只查@app/views/site/ - 用相对路径如
'../user/profile'，Yii 直接拼到当前viewPath后面，变成@app/views/site/../user/profile.php，系统不解析.. - 控制器继承自模块类，但模块的
viewPath被显式设成@app/views，导致本该查@app/modules/admin/views/的却跳去了应用级视图目录
render() 查找路径的优先级顺序
调用 $this->render('index') 时，Yii 按以下顺序定位文件（从高到低）：
- 当前控制器的
viewPath（默认是@app/views/{controller_id}/）→ 如ProductController对应@app/views/product/index.php - 若控制器属于模块，且模块设置了
public $viewPath，则优先用模块的viewPath - 模块未设
viewPath或该路径下无对应文件，则 fallback 到@app/views/根目录
注意：renderPartial() 和 render() 完全共享这套逻辑，区别仅在于是否套 layout。
跨目录渲染必须用完整别名路径
想在 SiteController 里渲染用户模块的视图，不能靠“猜路径”，得明确告诉 Yii 文件在哪：
- ✅ 正确写法：
$this->render('@app/views/user/profile')（带@app别名，不加.php） - ✅ 或临时改
viewPath：$this->viewPath = '@app/views/user'; $this->render('profile'); - ❌ 错误写法：
$this->render('../user/profile')、$this->render('user/profile')（没别名，Yii 就认作子目录）
别名必须已注册，否则报 Invalid path alias；@app 是内置别名，放心用。
Gii 生成 CRUD 后 404 的真实原因
不是路由或 URL 美化的问题，而是视图根本没放对地方。Gii 生成的 ProductController 会默认尝试渲染 @app/views/product/index.php —— 如果你手抖把文件拖进了 views/layouts/product/ 或 views/site/product/，Yii 就找不到。
- 必须确保目录结构严格为：
views/product/_form.php、views/product/index.php等 - 不能是
views/layouts/product/（那是 layout 存放区）、也不能是views/site/product/（那是 SiteController 的地盘） - 检查控制器类名是否与目录名小写一致：如
ProductController→views/product/，AdminUserController→views/admin-user/（注意连字符）
最稳妥的验证方式：在控制器 action 里加一行 var_dump($this->getViewFile('index'));，看输出路径是不是你预期的那个文件。
