WordPress网站从AWS迁移至GCP后媒体库图片不显示求助

1. 批量更新数据库中的媒体路径记录 #

WordPress媒体库依赖数据库存储文件的路径信息，迁移后旧图片的记录仍指向S3地址，需要批量替换：

• 备份数据库后，执行以下SQL语句（替换实际的旧S3域名和GCP存储桶域名，注意wp_是你的表前缀）：

  UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'https://旧S3桶域名/', 'https://GCP存储桶域名/') WHERE meta_key = '_wp_attached_file';
  UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'https://旧S3桶域名/', 'https://GCP存储桶域名/') WHERE meta_key = '_wp_attachment_metadata';
  UPDATE wp_posts SET guid = REPLACE(guid, 'https://旧S3桶域名/', 'https://GCP存储桶域名/') WHERE post_type = 'attachment';
  

• 比如旧S3域名为my-aws-bucket.s3.amazonaws.com，GCP域名为my-gcp-bucket.storage.googleapis.com，直接替换对应部分即可。

2. 核对GCP存储桶的文件结构 #

WordPress默认按「年/月」目录存储上传文件（例如2023/09/photo.jpg），检查GCP桶内的旧文件：

• 是否保留了和原S3一致的目录层级？如果直接把文件放到桶根目录，会和数据库记录的路径不匹配，导致媒体库无法识别。
• GCP存储桶区分文件名大小写，S3默认不区分，若迁移后文件名大小写变更，也会导致路径匹配失败，需要统一文件名大小写。

3. 刷新媒体库缓存与缩略图 #

• 安装Regenerate Thumbnails插件，批量重新生成所有图片的缩略图，这会强制WordPress重新扫描并关联媒体文件。
• 如果启用了对象缓存（如Redis、Memcached），手动清除缓存；也可以删除wp-content/uploads目录下的缓存文件（若存在）。

4. 检查WP Offload Media插件配置 #

• 确认插件已正确绑定GCP存储桶，「存储路径」设置和旧文件的目录结构一致（比如设置为wp-content/uploads/）。
• 进入插件的「媒体库」设置页，勾选「修复缺失的附件元数据」并执行修复，插件会自动同步数据库和存储桶的文件关联。
• 确保「重写文件URL」选项已开启，让旧的S3地址被替换为GCP地址。

5. 验证GCP存储桶的访问权限 #

• 检查桶级ACL：确保allUsers被授予Storage Object Viewer角色，允许匿名读取所有文件。
• 检查单个旧文件的权限：部分从S3迁移的文件可能保留了私有权限，需要批量设置为继承桶的公开权限（可通过GCP控制台的批量操作或gsutil命令完成）。

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