如何将WordPress所有媒体文件URL替换为自定义CDN/S3地址？

你之前直接更新wp_posts表post_content字段不生效，核心原因是WordPress的媒体地址并非只存在于正文字段中：历史附件的独立条目GUID、附件元数据、主题/插件存储的媒体配置都存在postmeta表中，同时你安装的Offload Media插件依赖专属元数据标记判断文件是否已经托管到S3，仅替换正文链接完全覆盖不到这些位置，自然不会生效。

以下是按优先级排序的可落地方案： #

方案1：使用Offload Media高级版自带批量处理工具（最稳妥，无数据损坏风险） #

你购买的高级版本本身就支持历史媒体的全量URL重写，之前开启重写开关无效，是因为插件默认不会自动识别你手动同步到S3的文件，需要手动触发批量处理流程：

• 第一步先核对路径映射：确认你同步到S3的文件路径和本地uploads目录的相对路径完全一致，比如本地wp-content/uploads/2022/06/2568.png，在S3存储桶里的路径必须是wp-content/uploads/2022/06/2568.png，不能多嵌套或者少嵌套目录。
• 进入WordPress后台的Offload Media设置页，找到批量处理板块，关闭「跳过已完成Offload的文件」选项，选择仅更新元数据与URL重写，不上传文件模式（你已经完成了文件同步，不需要插件重复上传占用带宽）。
• 启动批量处理任务，插件会自动遍历所有历史上传的附件，补充S3托管标记、更新所有位置的媒体URL引用，包括正文插入图、特色图像、小工具、主题函数调用的媒体资源，处理完成后所有历史文件会自动输出S3地址。
• 操作前记得备份数据库，避免极端情况数据异常。

方案2：手动全表更新数据库（适合批量工具识别异常的场景，需有数据库操作经验） #

如果插件批量工具识别路径出错，可以手动替换所有存储媒体URL的数据库字段，操作前必须全量备份数据库：

1. 先更新所有附件条目的GUID字段：

UPDATE wp_posts 
SET guid = REPLACE(guid, 'http://mywebsite/wp-content/uploads', 'http://s3.amazonaws-mywebsitelink.com/wp-content/uploads')
WHERE post_type = 'attachment';

2. 更新所有文章正文、摘要里插入的媒体链接：

UPDATE wp_posts 
SET post_content = REPLACE(post_content, 'http://mywebsite/wp-content/uploads', 'http://s3.amazonaws-mywebsitelink.com/wp-content/uploads'),
    post_excerpt = REPLACE(post_excerpt, 'http://mywebsite/wp-content/uploads', 'http://s3.amazonaws-mywebsitelink.com/wp-content/uploads');

3. 更新postmeta表中所有存储的媒体地址，覆盖特色图像、附件元数据、主题/插件保存的媒体配置：

UPDATE wp_postmeta 
SET meta_value = REPLACE(meta_value, 'http://mywebsite/wp-content/uploads', 'http://s3.amazonaws-mywebsitelink.com/wp-content/uploads');

4. 补充Offload Media的识别标记：找一条新上传、已经正常走S3地址的附件，复制它在wp_postmeta表中对应的S3元数据（一般元键为amazonS3_info），按照相同的序列化格式给所有历史附件补充对应的值，填入对应文件在S3的存储桶、路径信息，避免插件误判为本地文件。
5. 所有SQL执行完成后，清空站点的页面缓存、对象缓存、CDN缓存，再刷新页面验证资源加载情况。

之前操作失效的原因说明 #

• 定义WP_CONTENT_URL常量导致加载失败：你填写的地址多了/wp-content/uploads后缀，该常量对应的是wp-content目录的完整URL，正确格式应为http://s3.amazonaws-mywebsitelink.com/wp-content，但这种方式不会更新数据库中存储的附件元数据，依然会出现部分资源加载异常，不推荐使用。
• 前端JS替换URL的方案会产生两次资源请求，完全抵消CDN的性能收益，确实没有使用价值。

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