FreeScout帮助台系统迁移后图片URL更新指南

背景说明

在使用FreeScout帮助台系统进行服务迁移时，用户可能会遇到一个常见问题：当系统域名变更后，历史邮件回复中嵌入的图片链接仍然保持旧的URL地址。这种情况会导致用户在新域名环境下无法正常查看历史邮件中的图片附件。

问题本质

FreeScout系统将邮件内容（包括嵌入的图片链接）以原始HTML格式存储在数据库的threads表中。系统迁移时，这些存储的内容不会自动更新其中的域名信息，需要手动进行批量替换。

解决方案

方法一：数据库直接操作（推荐技术方案）

对于有数据库管理经验的用户，可以通过执行SQL更新语句批量修改图片链接：

UPDATE `threads` 
SET `body` = REPLACE(
    `body`, 
    'https://旧域名.com/storage/attachment/', 
    'https://新域名.com/storage/attachment/'
) 
WHERE `body` LIKE '%https://旧域名.com/storage/attachment/%' 
COLLATE utf8mb4_bin

注意事项：

1. 执行前务必备份数据库
2. COLLATE子句确保二进制精确匹配
3. 替换语句中的域名需包含完整协议头(http/https)
4. 路径部分必须完全匹配，包括结尾的斜杠

方法二：手动编辑（适用于少量记录）

对于少量需要修改的对话记录，可以通过FreeScout后台界面逐条编辑：

1. 登录管理员账户
2. 进入需要修改的对话记录
3. 编辑邮件内容中的图片链接
4. 保存修改

技术原理

FreeScout系统采用以下存储机制：

• 邮件内容以HTML格式原样存储
• 附件路径采用绝对URL形式
• 系统不自动重写历史内容中的URL

这种设计保证了数据的原始性和完整性，但也意味着在系统迁移时需要手动处理URL变更。

最佳实践建议

1. 系统迁移前应规划好URL变更方案
2. 重要操作前创建完整数据库备份
3. 可以在测试环境先验证SQL语句效果
4. 对于大型数据库，建议在低峰期执行批量更新
5. 更新后应抽样检查数据一致性

扩展知识

类似的问题可能出现在以下场景：

• 存储路径结构调整时
• HTTP/HTTPS协议切换时
• CDN域名变更时 掌握这种URL批量更新技术对系统运维具有重要意义。