迅睿CMS迁移后伪静态附件缓存全场景修复实操指南

一、准备工作 先完成3项前置操作，避免修复过程出乱子： 1. 备份数据：登录旧站/迁移后的新站后台→进入【系统】-【数据备份】，勾选「站点配置」「模板配置」「伪静态规则」「附件元数据」「内容栏目数据」，点击立即备份，将压缩包下载到本地保存。 2. 登录新站后台确认基本信息：核对【系统】-【站点配置】-【网站设置】里的「网站域名」（必须是http/https开头的完整新域名，尾部不要带/）「后台入口路径」「附件上传目录」。 3. 检查新站运行环境：确认是否支持原伪静态规则使用的重写模块（Apache用mod_rewrite，Nginx默认已有rewrite模块，IIS用URL Rewrite Module）。 二、核心场景1：伪静态规则失效（前台文章/栏目404） 90%以上的迅睿CMS迁移后链接失效，都是伪静态没配置对。按对应环境操作： 2.1 Apache环境修复 Apache用`.htaccess`文件控制伪静态，步骤如下： 1. 导出旧站伪静态规则备份：后台→【系统】-【伪静态规则】，点击右上角「导出」按钮，保存导出的`.htaccess`到本地。 2. 替换导出文件中的旧域名：用记事本/VS Code打开备份的`.htaccess`，按`Ctrl+H`批量替换所有旧域名为新域名（注意：如果旧规则里有绝对路径，也要同步替换为新路径）。 3. 上传替换后的规则文件到新站根目录：如果新站是宝塔面板，直接在文件管理器根目录粘贴；如果是虚拟主机，用FTP工具（推荐FileZilla，下载地址：https://filezilla-project.org/download.php）上传到public_html/wwwroot等根目录下。 4. 验证规则是否生效：打开宝塔Apache设置→配置文件，确保包含以下两行且未被注释（开头是注释）： ```apache LoadModule rewrite_module modules/mod_rewrite.so AllowOverride All ``` 虚拟主机联系主机商开启即可。 5. 后台更新伪静态缓存：回到新站后台→【系统】-【伪静态规则】，点击「生成静态规则到站点根目录」按钮。 2.2 Nginx环境修复 Nginx没有`.htaccess`，规则要写到网站配置文件里： 1. 导出旧站伪静态规则配置片段：后台→【系统】-【伪静态规则】，点击右上角「Nginx配置」标签，复制全部规则内容。 2. 修改规则片段：替换片段开头的`/旧站根目录`为新站根目录（如果新站直接在根目录，改成`/`），替换所有旧域名为新域名。 3. 修改新站Nginx配置： - 宝塔面板：左侧网站→找到对应域名→设置→伪静态，清空默认内容，粘贴修改后的规则片段，点击保存。 - 自建服务器：打开`/etc/nginx/sites-available/你的域名.conf`（路径可能略有不同），找到`server{}`块里的`location / { ... }`，替换为修改后的规则片段，保存后执行命令`nginx -t`检查语法，没问题再执行`nginx -s reload`重启Nginx。 4. 后台更新伪静态缓存：同2.1步骤5。 2.3 IIS环境修复 1. 安装URL Rewrite Module：如果没安装，到微软官网下载对应IIS版本的模块，下载地址：https://www.iis.net/downloads/microsoft/url-rewrite。 2. 导入旧站规则并替换：后台→【系统】-【伪静态规则】，点击右上角「导出」保存`web.config`→打开替换所有旧域名为新域名→上传到新站根目录。 3. 后台更新伪静态缓存：同2.1步骤5。 三、核心场景2：附件链接失效（图片/视频/文档打不开） 附件链接失效分两种情况： 3.1 附件上传后但文件未完全迁移 1. 检查附件目录是否一致：后台→【系统】-【附件管理】-【附件设置】，确认「本地存储路径」是否和旧站一致（默认是`/uploadfile/`，如果旧站改过必须同步修改）。 2. 重新传输附件文件：用FileZilla从旧站完整下载`uploadfile`目录（注意勾选「显示隐藏文件」，避免漏掉带.htaccess的缩略图缓存目录），然后完整上传到新站对应路径。 3. 修复附件元数据权限：宝塔面板右键`uploadfile`目录→权限→设置为755（如果有写入需求可临时设777，修复后改回），勾选「应用到子目录」。 3.2 文件已迁移但元数据里还是旧域名 1. 后台批量替换内容中的旧附件域名：后台→【系统】-【系统工具】-【内容替换】，「替换范围」选「全部栏目」，「替换字段」选「所有内容字段」，「查找内容」填旧域名+附件路径（比如`https://old.com/uploadfile/`），「替换内容」填新域名+附件路径（比如`https://new.com/uploadfile/`），点击开始替换。 2. 批量替换栏目/导航中的旧附件域名：同样用【内容替换】，「替换范围」选「栏目/分类」，「替换字段」选「所有栏目字段」，重复上述查找替换操作。 3. 批量替换附件元数据自身的旧域名：如果后台没自带工具，直接在宝塔面板/数据库管理工具（Navicat/PHPMyAdmin）执行SQL命令（注意替换成你的新/旧域名、表前缀，默认表前缀是`xunrui_`）： ```sql UPDATE xunrui_attachment SET url = REPLACE(url, 'https://old.com', 'https://new.com'); ``` 四、核心场景3：后台菜单/入口路径失效 如果旧站改过后台入口路径，新站迁移后没同步修改，可能进不去后台： 1. 直接通过物理路径登录：如果知道新站后台的实际文件夹名，直接访问`https://new.com/实际后台文件夹名/`（默认是`admin.php`）。 2. 同步修改后台入口配置：登录后台→【系统】-【站点配置】-【安全设置】，修改「后台入口路径」（和旧站一致，或者留空用默认admin.php），点击保存后，后台会自动刷新到新入口，注意以后只能用新路径登录。 五、全场景收尾：彻底清理所有缓存 完成上述修复后，必须清理所有缓存才能生效： 1. 清理后台系统缓存：后台→右上角齿轮图标（快捷设置）→点击「清理所有缓存」。 2. 清理前台静态缓存：后台→【系统】-【静态管理】-【清理缓存】，勾选「清理全部静态缓存」「清理缩略图缓存」「清理模块缓存」，点击立即清理。 3. 本地浏览器强制刷新：Windows按`Ctrl+F5`，Mac按`Cmd+Shift+R`，清除本地缓存后再测试前台所有链接。