WordPress 迁移后首页能开、内页 404 或图片裂图:先核伪静态与站点地址,再查媒体

迁移刚完成时,首页往往能打开,整站看起来也已经「搬过来了」。真正点开文章、产品或分类,却常见两种情况:内页直接 404;或者文字在,图片全是裂图。这类问题很容易被当成「数据没导全,再导一次」,或「先改一下固定链接、再开一层 CDN」。现场更常见的是另一条线:新环境的伪静态规则没有生效,站点地址还对不上当前访问,数据库里仍写着旧地址,或 uploads 没有完整同步。首页能开,并不等于内页重写已经生效,也不等于媒体已经在新环境可用。

这和已经写过的「迁移换主机后图片裂图或内链仍指向旧域名」(11-04-2000)不是同一条主线:那篇卡在 Search-Replace、序列化校验、uploads 与 CDN;本文会把它作为图片与内链的一条支路来核,但先处理「首页能开、内页却 404」------伪静态、站点地址,以及内容是否迁全。也要和「固定链接改成文章名后全站 404」「自定义文章类型前台报 404」「改版后旧产品页或广告落地页大面积 404」分开:那些是改固定链接、自定义类型 rewrite,或改版后的 301 映射;本文默认是刚迁完主机或域名,新首页能打开,但原来的内页打不开,或图片请求失败。挂 CDN 后静态资源 404、站点地图本身 404,也不在本篇主问题上。还没有把「伪静态有没有生效、站点地址是否与当前访问一致、内容是否迁全、图片是旧地址还是文件缺失」看清之前,不要先改固定链接结构,也不要同时做一次全库替换和切换 CDN。

更稳的顺序是:先分清是「所有内页 404」「跳回旧站或重定向循环」「只有部分页面 404」,还是「图片仍指向旧域名、新地址 404、403 或混合内容」→ 先核伪静态与站点地址,必要时刷新重写规则 → 再按浏览器里的图片请求,检查媒体文件、安全替换与缓存 → 最后做验收和回滚。别一上来同时改固定链接、全库替换和清理 CDN。

先分清:伪静态未生效 / 站点地址不一致 / 内容或结构变了 / 图片地址或文件不完整

「迁移后首页能开、内页 404 或图片裂图」至少有四条岔路,混着改容易把重写规则、站点地址、媒体文件和缓存一起误判:

  • 首页正常,所有文章页或产品页都 404:几乎都是伪静态(重写规则)没有在新环境生效。Apache 环境可能缺少 .htaccess,或虚拟主机不允许覆盖;Nginx 环境可能没有把请求交给 index.php;面板里也还没选 WordPress 规则。这不是「再导一次数据库」能单独解决的。
  • 访问时跳回旧域名,或提示重定向次数过多:siteurl / home 与当前访问的协议、是否带 www、域名不一致;或站点在反向代理、CDN 后面时,WordPress 没有正确识别 HTTPS。
  • 只有部分页面 404:内容可能没有迁全,或固定链接结构、分类、别名在新站发生了变化。结构确实需要改时,要为旧地址准备 301,而不是只点一次「保存固定链接」。
  • 文字在、图片裂:先看浏览器请求的是哪个地址。仍是旧域名,说明数据库未替换完整;已经是新域名却返回 404,多半是 uploads 没同步或路径不对;返回 403,要看权限和防盗链;HTTPS 页面里还在引用 http 图片,则会被当成混合内容拦截。

先记下:出问题的是全部内页、某一种内容类型,还是某几张图;当前访问的域名、协议和是否带 www;后台「设置 → 常规」里的站点地址是否一致;裂图请求是旧地址、新地址 404,还是 403。明确这是 迁移后的伪静态、站点地址与媒体核对,不是改版后的旧链接 301 专文,也不是只处理内链仍指向旧域名的 Search-Replace 专文。

第一步:定界 ------ 这次卡在规则、地址、内容还是媒体

不要先改固定链接结构,更不要先对全库做替换或切换 CDN。先把边界看清楚:

  1. 先分清是「所有内页 404」还是「只有部分 URL 打不开」:全部内页 404,优先看伪静态。可以先打开一篇已知存在的文章、一个分类页和一个附件页:如果这三类全部 404,就先不要怀疑某一篇文章的别名写错。只有个别文章、分类或附件打不开,再去对内容数量、别名和固定链接结构。
  2. 看会不会跳回旧站,或出现重定向循环:若浏览器地址栏被拉回旧域名,或反复跳转,先核站点地址和 HTTPS 识别,而不是先刷新缓存。把当前地址栏里的协议、是否带 www、域名,和后台「设置 → 常规」里的 WordPress 地址、站点地址并排抄下来,不一致就先记在这条线上。
  3. 裂图不要先猜「文件丢了」:在裂图上打开原图,或在开发者工具里看图片请求的地址和状态码。仍指向旧域名或旧 IP,和已经是新域名却 404,处理顺序完全不同;403 和混合内容也不要并进「再传一次图库」里。
  4. 对照新旧两站的已发布内容数量:文章、页面,以及实际在用的产品或自定义类型,都要分别点一下数量。数量明显变少,先补数据,而不是先改主题或固定链接;数量一致但仍有部分 404,再看结构是否被改过。
  5. 把这次迁移的范围写下来:只换主机、同时换域名,还是也改了目录和协议。只换主机但域名不变时,重点常在伪静态和文件同步;连域名或协议一起改时,站点地址和数据库替换范围会更大。若主要问题是改版后广告落地页还在打旧地址,应走改版 301 专文,而不是按「搬家后伪静态没生效」来处理。

预期:能一句话说清「卡在伪静态未生效、站点地址不一致、内容或结构变了,还是图片地址/文件不完整」;并确认不是改固定链接后的全站 404 专文,也不是改版后旧链接 301 专文。

第二步:先核伪静态与站点地址,再决定改不改结构

定界之后,先让「内页能不能按新环境的规则打开」清楚,再谈替换和媒体:

  1. 确认新环境已经加载 WordPress 重写规则:Apache 要有包含默认规则的 .htaccess,并且允许覆盖;若文件在迁移时没带过来,只把数据库导过去,首页往往仍能开,文章页却会整片 404。Nginx 要在站点配置里用 try_files 把前端请求交给 index.php;宝塔等面板可直接选择 WordPress 伪静态规则,改完后重载再测。规则没生效时,先不要改固定链接结构。
  2. 到后台「设置 → 固定链接」保存一次,刷新重写规则:这一步是让新环境重新写出当前结构对应的规则,不是让你顺手换成另一种结构。也可以用 WP-CLI 执行 wp rewrite flush --hard,再抽查文章页、分类页和附件页。只清页面缓存,替代不了重写规则刷新。
  3. 核对 siteurl 和 home 与当前访问完全一致:协议是 http 还是 https、是否带 www、域名是否已经切到新地址,都要和浏览器地址栏一致。用了 CDN 或反向代理时,还要确认 WordPress 能识别 HTTPS,否则容易出现「重定向次数过多」。这里不要先改固定链接结构来「绕开」跳转,先把地址本身对齐。
  4. 内容数量一致但部分 URL 仍 404 时,再看结构有没有变:例如旧站是文章名结构,新站变成了存档编号。结构确实需要变化,应先为旧地址配置 301,而不是指望刷新一次固定链接就把已收录的旧链接救回来。这和「改版后专门做旧链接映射」是相邻动作,但起点仍是这次迁移有没有把结构一起改掉。
  5. 先修一条能复现的内页,再推广到全站抽查:先让一篇文章、一个分类和一个附件页在新域名下稳定打开,再批量复查。别一上来同时改固定链接、替换数据库和切换 CDN。若样本内页已经能开,其余页面仍大面积 404,再回头对内容是否迁全,而不是继续叠加新的重写插件。

预期:能指出问题主要来自伪静态未生效、站点地址不一致,还是结构被改过;样本内页可以打开;没有为了「先让链接更好看」同时改结构和做全库替换。

第三步:再查媒体文件与地址替换,缓存一次对齐

内页能打开之后,再按图片请求处理裂图和旧地址:

  1. 先看请求地址,再决定是替换还是补文件:地址仍是旧域名或旧 IP,走数据库替换;地址已是新域名但 404,去对 wp-content/uploads 的文件数量和总大小,必要时空出流量限制后用 rsync 或 SFTP 补传。部分迁移工具会因为体积限制跳过媒体库,看起来「文章都在」,图却只剩数据库记录。原图在而列表缩略图裂开,再补生成缺失的尺寸,不必把整库原图重传一遍。
  2. 替换旧地址时不要直接用 SQL 的 REPLACE:小工具、主题设置和页面构建器里常见序列化数据,直接替换会把长度改坏,设置看起来像丢了。应使用支持序列化的 WP-CLI search-replace,先用 dry-run 预演,再正式执行。http 与 https、带 www 与不带 www,以及页面构建器里被转义的地址写法,都要覆盖到,否则首页换过来了,内页背景图还指向旧站。
  3. 检查上传路径选项和权限:upload_path、upload_url_path 若还留着旧服务器的绝对路径,前台仍可能裂图。上传目录属主应为 Web 服务运行用户,目录和文件权限过严或过宽都会表现为 403。后台媒体库能看到缩略图、前台却不显示时,优先怀疑页面里仍是旧地址,或缓存了旧的 HTML,而不是先重装媒体插件。
  4. 对象存储、防盗链和 CDN 要一起核:原来把媒体放到对象存储时,新环境的插件配置、存储桶和访问域名都要能公开读取;面板或 CDN 的防盗链要把新域名加进去,否则会出现「文件在、前台 403」。CDN 可能缓存了迁移期间的 404 响应,文件补上或地址替换完成后,要清理对象缓存、页面缓存和 CDN,再验证。
  5. 涉及先核伪静态与站点地址、再查媒体时,把清单单独勾掉 :可对照 迁移后首页能开、内页 404 与图片裂图时把伪静态、站点地址和媒体核对清楚的要点 把「重写规则是否生效、站点地址是否与当前访问一致、内容是否迁全、图片请求是旧地址还是文件缺失、替换是否做过预演并清理缓存」从清单里单独勾掉:先让内页可打开、媒体可显示,再决定是补 301、改结构,还是继续切 CDN------顺序反了,换完加速之后仍然说不清卡在哪一步。在 DEVDIY 的迁移验收里,也是先把这几项勾完,再讨论要不要改固定链接或切换存储。

预期:能指出裂图是旧地址未替换、文件未同步、权限/防盗链,还是缓存了迁移中的 404;样本图片可以打开;没有在规则还没生效时做一次不可回滚的全库替换。

回滚点

改伪静态规则、站点地址、数据库替换或媒体同步之前,先保留新旧两端的完整备份(数据库与 wp-content)。优先在维护窗口先改一条可复现的内页和一张裂图。旧服务器先不要立刻回收,补传遗漏文件时还用得上。若内页 404 更多、图片更乱,或出现重定向循环,立即回到改之前的规则、站点地址和数据库,不要继续叠加全库替换和 CDN 切换。生产上不要同时改固定链接结构、全库替换和存储方式。

验收

  1. 首页之外,文章页、分类页、必要的产品页和附件页可以打开,不再整片 404;若结构有意调整,旧地址已有 301。
  2. siteurl 与 home 与当前访问的协议、域名和 www 规则一致,不再跳回旧站,也没有重定向循环。
  3. 样本页中的正文图、列表缩略图、主题或构建器里的背景图,请求的是新地址且能打开;对象缓存、页面缓存和 CDN 已在修复后清理。
  4. 复查 24h:抽查过的内页和图片没有因缓存退回旧地址或 404;没有并行做第二次无预演的全库替换。有搜索资源平台账号时,可再扫一遍新增的抓取错误,并重新生成站点地图,这是收尾,不是本篇的起点。

常见坑

  • 只看首页能打开,就判断「迁移已经完成」。
  • 所有内页 404 时,先改固定链接结构或再导一次数据库,而不先核伪静态。
  • 把「搬家后内页 404」和「改版后旧落地页 404」混成同一个问题,只补 301 或只刷新固定链接。
  • 看见裂图就对数据库做 SQL 批量替换,把序列化的主题设置和小工具改坏。
  • 媒体库后台看得到图,却不检查前台页面里是不是还在用旧地址,或缓存了旧 HTML。
  • 文件补传或地址替换完成后,不清理页面缓存和 CDN,继续命中迁移期间的 404 响应。
  • 还没有让样本内页和样本图片稳定可开,就同时改结构、全库替换和切换对象存储。

迁移验收要的是「首页能开」「内页也能开」和「图片请求的是新环境且打得开」同时成立。先核伪静态与站点地址,再查媒体,比先改固定链接或先做一次全库替换更稳。样本页面和样本图片验证清楚之后,再决定要不要调整结构和存储。

相关推荐
李纲明9 小时前
WordPress 外贸主题切语言后版式乱或海外很慢:先核翻译插件适配,再查海外节点与询盘
wordpress·多语言·询盘·devdiy·主题选型·外贸站·wpml
李纲明1 天前
WordPress 询盘跟进不及时或投放渠道对不上:先核通知与 UTM,再查表单插件是否重复
wordpress·utm·devdiy·询盘通知·表单插件·渠道追踪·线索跟进
李纲明1 天前
WordPress 切换语言后仍是原文或页面串语:先核译文关联与页面缓存,再查切换器落地
wordpress·多语言·页面缓存·语言切换·切换器·devdiy·译文关联
李纲明2 天前
WordPress 企业官网主题很好看、改页就变慢或询盘接不上:先核场景与组件,再查子主题
wordpress·企业官网·devdiy·主题选型·子主题·组件体系·询盘对接
李纲明3 天前
WordPress 页面加载时布局乱跳或按钮要点两次:先核图片占位与字体,再查第三方脚本与 INP
wordpress·cls·inp·devdiy·布局偏移·字体预留·第三方脚本
李纲明3 天前
微信小程序开了 Skyline 后样式全乱、滚动对不上甚至部分组件不能用?Skyline 怎么接才稳
javascript·微信小程序·小程序·devdiy
李纲明3 天前
微信小程序等位大桌被小桌占掉或过号回来就闹:先核桌型分队与过号容忍次数,再查门口屏与推送同源
微信小程序·devdiy·等位排队·桌型分队·过号重排·门口屏·推送同源
李纲明3 天前
WordPress 上传目录能执行 PHP 或权限过宽:先禁脚本执行并收紧权限,再清异常文件
wordpress·文件权限·安全加固·devdiy·上传目录·php执行·异常脚本
李纲明3 天前
WordPress 打开站点却直接下载文件或源码而不显示页面:先核 PHP 处理规则,再查 443 是否被其他站接管
nginx·wordpress·443·php解析·站点配置·devdiy·直接下载