WordPress站点上线后无法加载JS/CSS 控制台报404错误

该故障为XAMPP本地环境迁移至线上环境的高频问题，按以下优先级逐一排查即可定位解决：

• 第一步：修正站点根域名配置
  若可正常进入站点后台，直接进入「设置-常规」页面，核对WordPress地址（URL）、站点地址（URL）两项配置，必须与线上实际访问域名完全一致，不得残留localhost、本地端口、本地子目录等本地环境配置项。
  若无法进入后台，直接编辑站点根目录下的wp-config.php文件，在文件末尾添加两行硬编码配置，该配置优先级高于数据库存储值：

  define('WP_HOME', 'https://你的线上正式访问域名');
  define('WP_SITEURL', 'https://你的线上正式访问域名');
  

  注意域名末尾不要添加多余斜杠，保存后清除浏览器缓存刷新测试。
• 第二步：全库替换残留本地路径
  本地搭建时数据库会写入大量带本地域名的静态资源路径，迁移时未替换完全就会触发资源404。完成上述域名硬配置后，使用Better Search Replace插件做全库搜索替换：
  • 搜索项填写本地环境旧地址，例如http://localhost/你的本地站点目录名
  • 替换项填写线上正式域名
  • 勾选全部数据表，先开启「试运行」模式确认匹配条目数量正常，再执行正式替换
    替换完成后清空站点插件缓存、服务器缓存、CDN缓存再测试。
• 第三步：修复Web服务重写规则
  迁移后未正确配置重写规则是静态资源被拦截返回404的最常见原因：
  • Nginx环境：确认站点配置文件中包含WordPress官方标准重写规则，配置完成后重载Nginx服务：

    location / {
        try_files $uri $uri/ /index.php?$args;
    }
    

  • Apache环境：确认站点根目录.htaccess文件存在且内容为WordPress默认规则，同时确认Apache已开启mod_rewrite模块，配置完成后重启Apache服务：

    # BEGIN WordPress
    <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
    RewriteRule ^index\.php$ - [L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . /index.php [L]
    </IfModule>
    # END WordPress
    

• 第四步：核对文件完整性与权限
  确认本地wp-content目录下的themes、plugins、uploads三个子目录已完整上传至线上服务器，无文件缺失；服务器目录权限设置为755，文件权限设置为644，避免因权限不足导致Web服务无法读取静态资源。

故障效果参考

• 首页异常：
• 内页异常：

快速验证技巧：打开浏览器开发者工具的控制台面板，查看报404的资源请求路径：如果路径中仍包含localhost字段，属于路径残留问题，按第二步操作修复；如果路径为线上正式域名但仍返回404，优先按第三步、第四步排查重写规则和文件状态。

内容的提问来源于stack exchange，提问作者Alexandru Andrei