迅睿CMS附件路径错误全场景修复实操指南 附排查步骤及验证方法

前置准备

操作前必须完成2项准备，避免操作失误导致站点瘫痪：

• 全站文件+数据库备份，可直接在迅睿后台【系统-系统维护-数据备份】一键完成，或者手动打包站点根目录、导出MySQL数据库
• 获取站点FTP/宝塔面板文件管理权限，确保可修改根目录下的配置文件、调整目录权限

常见报错场景与对应修复步骤

场景1：换域名/迁服务器后所有附件路径报错404

该场景占附件路径报错的80%以上，原因是系统配置里的站点域名、附件根路径仍为旧环境的值，修复步骤如下：

1. 登录迅睿CMS后台，进入【系统-系统配置-站点设置-基本参数】，找到站点域名配置项，修改为当前站点的完整域名（带http/https前缀，末尾不要加斜杠，格式示例：https://www.xxx.com）
2. 同页面找到附件URL地址配置项，本地存储默认填/uploadfile/即可；如果站点部署在域名子目录，需要补全子目录前缀，比如站点访问地址是https://www.xxx.com/cms/，此处填/cms/uploadfile/；如果使用第三方OSS存储，填OSS的访问域名+路径
3. 进入【系统-系统维护-缓存管理】，勾选所有缓存选项，点击全部清除，刷新前台页面验证附件是否可正常访问

如果迁移后后台无法登录，可直接手动修改配置文件生效：打开根目录/config/param.php，找到以下配置项修改为对应值：

``` // 站点域名 'site_url' => 'https://www.xxx.com', // 附件访问地址 'attachment_url' => '/uploadfile/', ```

修改保存后，删除根目录/runtime/cache/下的所有文件即可生效。

场景2：单篇内容/单个栏目附件路径错误，其余内容正常

该场景原因是栏目单独配置了错误的附件路径，或者发布内容时编辑器自动插入了旧绝对路径，修复步骤如下：

1. 排查栏目配置：进入后台【内容-栏目管理-对应栏目-参数设置】，检查栏目附件目录配置项，是否存在拼写错误、多余斜杠，默认留空即可继承全局配置，如有错误修改后保存
2. 排查单篇内容：如果是单篇内容的附件错误，进入内容编辑页，切换到编辑器源码模式，检查附件的src属性是否为旧域名/错误路径，直接批量替换为正确路径后保存内容即可
3. 批量修复历史内容：如果有大量历史内容嵌入了旧域名，可提前备份数据库后执行SQL语句批量替换，代码示例：

``` UPDATE dr_1_news SET content = REPLACE(content, 'http://旧域名.com', 'https://新域名.com'); ```

注意：dr_1_news是对应内容模型的表名，1是站点ID，news是模型标识，可在后台【内容-内容模型-模型管理】查看对应表名；旧域名要填写完整带http/https前缀，避免误替换内容中的普通文本。执行完成后清除全站缓存即可生效。

场景3：上传附件时提示“路径创建失败/权限错误”

该场景原因是附件存储目录没有写入权限，或者配置的存储路径不存在，修复步骤如下：

1. 检查根目录下/uploadfile/目录是否存在，不存在则手动创建，权限设置为755，所有者设置为站点运行用户（比如宝塔面板默认的www用户），虚拟主机环境直接设置目录为可读可写即可
2. 如果自定义了附件存储目录，检查/config/param.php里的'attachment_path'配置项，值必须是根目录下的相对路径，比如默认值为'uploadfile'，不要加斜杠，确保对应目录存在且有权限
3. 如果是OSS/COS等第三方存储，检查存储配置的 Bucket 名称、地域、访问密钥是否正确，跨域配置是否添加了当前站点域名，回调地址是否为当前域名，存储域名是否在有效期内且已备案

特殊场景修复方案

子目录部署站点附件路径特殊配置

如果站点不是部署在域名根目录，而是子目录（比如访问地址为https://www.xxx.com/cms/），需要额外修改3处配置：

• 根目录/config/param.php的site_url填https://www.xxx.com/cms，attachment_url填/cms/uploadfile/
• Apache环境修改根目录/.htaccess文件，在RewriteBase后面补全子目录，示例：RewriteBase /cms/
• Nginx环境在站点配置的location / 块中添加以下规则：

``` if (!-e $request_filename) { rewrite ^/cms/(.)$ /cms/index.php?s=$1 last; } ```

修改完成后重启Nginx，清除全站缓存即可。

多站点模式附件路径错误修复

迅睿多站点模式每个站点可单独配置附件路径，修复步骤如下：

• 进入后台【系统-站点管理-对应站点-基本设置】，分别修改每个站点的独立域名和附件URL配置
• 如果需要多站点共用附件池，在主站点配置中将attachment_url设置为统一的附件域名，子站点的attachment_path配置指向主站点uploadfile目录的绝对路径即可

修复后验证操作

所有配置修改完成后，必须按以下步骤验证，避免遗漏问题：

• 前台随机打开10篇以上不同栏目的内容，检查图片、附件、视频是否能正常加载，无404、403报错
• 后台上传一张测试图片，插入到新内容中发布，检查前台是否能正常显示，上传过程无报错
• 打开浏览器F12开发者工具的【网络】面板，刷新页面检查所有附件请求的状态码均为200，没有跨域、路径拼接错误问题

常见卡壳问题解决方案

• 修改配置后仍显示旧路径：确认是否清除了全部缓存，包括服务器缓存、CDN缓存、浏览器本地缓存，可直接删除runtime目录下所有文件强制刷新缓存
• 附件路径出现双斜杠：检查site_url和attachment_url配置末尾是否加了斜杠，两个配置末尾都不能加斜杠，否则会出现//的错误拼接路径
• Linux服务器权限设置后仍报错：执行命令chown -R www:www /站点根目录/uploadfile/（www为站点运行用户，根据实际情况替换），再执行chmod -R 755 /站点根目录/uploadfile/即可