yii2静态资源404的根源是assets目录缺失或不可写、assetbundle basepath/baseurl配置错误、url重写规则误拦截，需检查webroot结构、权限、路径别名及手动发布资源。
Yii2.0.55项目部署后静态资源（如css、js、图片）在浏览器中显示404或完全不加载，说明资源路径未被正确解析或服务器无法读取文件，不是代码逻辑错误，而是部署环节的路径映射、权限或AssetBundle配置脱节。
确认webroot目录结构是否符合Yii2约定
进入部署服务器，检查web目录（即Web服务器DocumentRoot指向的目录）下是否存在index.php，并确认其同级目录包含assets、css、js、images等资源文件夹。若dist打包产物直接丢进web目录但缺少assets子目录，Yii2默认不会自动创建——【assets目录必须存在且可写】，否则AssetBundle无法发布资源。
运行命令验证：ls -la /var/www/html/（路径按实际替换），确保assets目录权限为755，属主为web服务器运行用户（如www-data）。
若assets为空或不存在，手动创建并赋权：mkdir -p assets && chown www-data:www-data assets && chmod 755 assets。
检查AppAsset类中basePath和baseUrl设置
打开@app/assets/AppAsset.php，重点核对这两行：
public $basePath = '@webroot'; —— 表示资源物理路径根目录，必须真实指向web服务器能访问的文件系统路径；
public $baseUrl = '@web'; —— 表示资源URL前缀，对应Web服务器对外暴露的URL根路径，比如站点域名为https://example.com，则@web应解析为/而非/frontend/web之类嵌套路径。
若部署时把项目放在子目录（如/myapp/），则$baseUrl必须显式设为'/myapp'，否则生成的标签会从根路径找资源，导致404。
强制触发AssetBundle资源发布
Yii2默认在首次访问时自动发布AssetBundle资源到assets目录，但生产环境常关闭调试模式，导致发布失败且无提示。
第一步：临时启用调试，在web/index.php顶部确认以下两行已开启：
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');
第二步：清空runtime/cache和assets目录：rm -rf runtime/cache/* assets/*；
第三步：刷新页面，观察assets目录是否生成新子目录（如assets_abc123）及内部文件；若仍为空，说明AssetBundle注册失败或路径不可写。
验证静态资源URL是否被重写规则拦截
方法一：直接在浏览器地址栏输入一个已知存在的CSS路径，例如https://yourdomain.com/css/site.css，看是否返回内容或404。
方法二：打开F12开发者工具→Network标签→刷新页面→筛选CSS/JS请求→查看失败项的状态码：
若状态为301/302且Location跳转到首页，说明IIS或Nginx的URL重写规则误匹配了静态路径；
若状态为403，说明服务器文件权限或SELinux策略阻止了读取；
若状态为404且URL明显多了一层路径（如/admin/css/site.css但实际文件在/css/site.css），则是前端模板里用了相对路径而非Yii::getAlias('@web')动态生成。
对于Nginx，检查是否有location ~ \.(js|css|png|jpg)$ { ... }块缺失或root路径错误；对于IIS，检查web.config中<rule></rule>是否用<match url="."></match>无差别捕获所有请求。
使用console命令手动发布资源
第一步：确保当前工作目录为项目根目录（含yii文件）；
第二步：执行命令：php yii asset/assets.php @app/config/assets-prod.php assets/（若存在预定义配置文件）；
第三步：若无配置文件，直接运行：php yii asset --interactive，按提示选择AppAsset类并指定输出目录为assets；
这一步会跳过运行时自动发布机制，直接将资源复制到assets目录并生成映射表，绕过所有缓存与权限判断盲区。
