Yii2.0.55生产环境部署问题需逐项核查：Web根目录必须指向/web子目录，runtime和assets目录须存在且可写，控制器须继承yii\base\Controller并替换Yii::app()为Yii::$app，表单须改用ActiveForm并补全命名空间，Nginx伪静态规则需启用且urlManager中showScriptName设为false，同时禁用YII_DEBUG以确保生产环境安全稳定。
Yii2.0.55项目在生产环境部署后出现500错误、静态资源404、URL带index.php、表单提交失败等问题，说明关键环节未按框架约定执行，必须逐项核验路径、权限、配置与代码迁移状态。
确认Web服务器根目录指向/web子目录
登录宝塔面板 → 网站 → 你的站点 → 根目录：必须设为/www/wwwroot/your-site/web（不是项目根目录）。若仍指向/www/wwwroot/your-site，则config/、runtime/等敏感目录可能被直接访问，且require语句因路径错乱触发Fatal error。
检查web/index.php是否存在且可读；若用Nginx，需确认PHP版本≥7.4（Yii2.0.55在PHP 8.1下运行最稳）。
若使用phpEnv，打开控制面板 → 网站管理 → 编辑站点 → 将「网站目录」改为D:\phpenv\www\your-site\web；Windows下注意web/index.php文件扩展名不可为.txt。
验证runtime和assets目录权限与存在性
执行ls -la /www/wwwroot/your-site/，确认runtime和assets目录存在且属主为Web服务器运行用户（如www-data或www）。
若assets目录不存在或为空：【assets目录必须存在且可写】，否则AssetBundle无法发布前端资源，所有CSS/JS均返回404。立即执行：mkdir -p assets && chown www-data:www-data assets && chmod 755 assets。
清空runtime/cache和assets内容：rm -rf runtime/cache/* assets/*，为后续资源发布准备干净环境。
修正控制器继承与应用实例调用
打开任意控制器（如controllers/SiteController.php），检查类定义首行是否为：class SiteController extends yii\base\Controller。若仍为extends CController，将立即报Class 'CController' not found。
全局搜索Yii::app()，所有出现位置必须替换为Yii::$app。例如：Yii::app()->db → Yii::$app->db；Yii::app()->user->id → Yii::$app->user->id。【继续保留Yii::app()会直接抛出Fatal error: Call to undefined method Yii::app()】。
检查控制器中是否有$this->layout = 'main'写在类体顶层（非方法内）。Yii2.0完全忽略此类赋值，必须移入actionIndex()等方法中，或设为public $layout = 'main';。
修复表单语法并补全命名空间
方法一：批量替换旧表单代码
删除所有$this->beginWidget('CActiveForm')及其配套endWidget()；在文件顶部添加use yii\widgets\ActiveForm;；将<?php $form=$this->beginWidget('CActiveForm'); ?>替换为<?php $form = ActiveForm::begin(); ?>；将<?php echo $form->textField($model,'name'); ?>替换为= $form->field($model, 'name')->textInput() ?>。
方法二：快速定位遗漏点
执行grep -r "CActiveForm\|CHtml::" ./views/，对输出的每个文件逐个打开修复；【忘记use yii\widgets\ActiveForm会导致Class 'ActiveForm' not found】。
配置Nginx伪静态与URL美化
第一步：进入宝塔站点设置 → 伪静态 → 选择「Laravel5」模板（与Yii2重写逻辑一致），或手动粘贴规则：
location / {<br> try_files $uri $uri/ /index.php?$args;<br>}
第二步：修改config/web.php中urlManager配置：
'urlManager' => [<br> 'enablePrettyUrl' => true,<br> 'showScriptName' => false,<br>],
第三步：点击「重载配置」，否则Nginx不生效；若仍跳转到index.php?r=site/login，说明showScriptName未设为false或伪静态未启用。
设置生产环境常量并禁用调试
编辑web/index.php，确保前两行为：
defined('YII_DEBUG') or define('YII_DEBUG', false);<br>defined('YII_ENV') or define('YII_ENV', 'prod');
若仍开启YII_DEBUG，生产环境将暴露敏感信息（如数据库连接详情、堆栈跟踪），且AssetBundle可能因调试模式干扰而发布异常。
检查config/environments/prod/web.php是否存在，并确认其已通过init脚本合并进主配置（高级模板需运行./init --env=Production --overwrite=All）。
