WordPress 全站 HTTPS 迁移实战:证书部署、WP-CLI 批量替换与不丢收录
一、问题背景与根因:为什么不能“边部署证书边迁移”
很多旧教程的顺序是:先到「设置 → 常规」把 WordPress 地址和站点地址改成 https://,再去申请证书。这个顺序在 WordPress 上几乎必然出事故,根因有三条。
根因 1:站点地址写在数据库里。siteurl 与 home 存在 wp_options 表。一旦改成 https 而 443 端口还没通,所有 wp-admin 请求都会被 302 到一个打不开的地址,登录态丢失,后台直接进不去,只能改数据库抢救。
根因 2:序列化数据被破坏。WordPress 把主题选项、小工具、页面构建器配置以 PHP 序列化字符串存库,形如 s:22:"http://example.com";。用 SQL 的 REPLACE() 直接替换,字符串长度变了但前缀 s:22 没变,unserialize() 直接失败,表现为“迁移后排版全乱、小工具消失”。
根因 3:混合内容被浏览器拦截。正文、CSS、JS 里残留的 http:// 资源在 HTTPS 页面下会被 Chrome、Safari 阻断,页面看起来“少了东西”却查不到原因。
正确顺序是一条单向流水线:证书就绪 → 验证 https 可访问 → 改站点地址 → WP-CLI 精确替换 → 服务器层 301 → 混合内容清理 → 收录迁移。任何两步并行,都会让排查成本翻倍。下面按这个顺序给出可直接执行的命令。
二、第一步:部署证书并验证 https:// 完全可访问
迁移的前提是 https 已经能稳定返回 200。以 Nginx + Certbot 为例:
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
sudo certbot renew --dry-run
--dry-run 必须通过,否则 90 天后证书静默过期,全站报 NET::ERR_CERT_DATE_INVALID。Certbot 会自动写入 systemd timer,用 systemctl list-timers | grep certbot 确认定时任务存在。
Nginx 里务必使用 fullchain.pem 而不是 cert.pem,否则移动端和部分客户端会报证书链不完整:
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
验证证书链与有效期:
curl -sI https://example.com | head -1
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
要点:公有 CA 签发的证书有效期上限为 398 天;Let’s Encrypt 固定 90 天,靠 ACME 自动续期。此时不要急着开 HSTS——一旦加上 includeSubDomains,任何还没配证书的子域都会立刻不可访问。
三、第二步:备份并修改站点地址
改地址前先导出全库,这是唯一的后悔药:
wp db export backup-$(date +%F-%H%M).sql
wp option get home
wp option get siteurl
确认 https 可访问后执行更新:
wp option update home 'https://example.com'
wp option update siteurl 'https://example.com'
多站点网络需要逐站处理,注意加 --url 参数指定子站:
wp site list --fields=blog_id,url
wp option update home 'https://sub.example.com' --url=sub.example.com
强烈建议同时在 wp-config.php 里加常量,它的优先级高于数据库,出问题时改两行就能抢回后台:
define('WP_HOME', 'https://example.com');
define('WP_SITEURL', 'https://example.com');
注意常量一旦定义,后台「设置 → 常规」里的两个输入框会变灰且修改无效,排查时极易误判。所以要么只用常量,要么只用数据库,不要两套并存还写成不同的值。
四、第三步:WP-CLI 批量替换旧链接(含序列化保护)
核心命令是 wp search-replace,它走 PHP 反序列化再重新序列化的路径,能自动修正长度前缀。先跑 --dry-run 看报告:
wp search-replace 'http://example.com' 'https://example.com'
--all-tables
--precise
--recurse-objects
--skip-columns=guid
--report-changed-only
--dry-run
确认输出无异常后去掉 --dry-run 再执行一次。参数含义:
--all-tables:覆盖非wp_前缀的自定义表,WooCommerce、页面构建器、表单插件都会建自己的表。--precise:按 PHP 序列化规则替换,缺了它就可能破坏序列化数据。--recurse-objects:递归处理嵌套对象与数组。--skip-columns=guid:guid是文章的永久标识,改了会让 RSS 订阅者把旧文当新文重收,搜索引擎也可能判定为重复内容。--report-changed-only:只打印真正发生变化的表,避免几十万行输出刷屏。
替换完成后清理缓存与固定链接:
wp cache flush
wp transient delete --all
wp rewrite flush --hard
如果站点使用过 //example.com 这种协议相对写法,需要单独再替换一次,但它会误伤已存在的 https://example.com,务必先 dry-run 核对报告再落地。
五、第四步:在服务器层做 301 强制跳转
跳转必须放在 Web 服务器或 CDN 边缘,不要交给插件。插件跳转要经过 PHP 和数据库,白白消耗资源,还会和服务器规则叠加成死循环。
Nginx 用独立的 80 端口 server 块:
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
Apache(.htaccess 或 VirtualHost 内):
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
验证跳转是否正确:
curl -sI http://example.com | grep -iE '^(HTTP|location)'
# 期望 HTTP/1.1 301 Moved Permanently
# 期望 Location: https://example.com/
如果站点在 Cloudflare 后面,SSL/TLS 模式必须设为 Full (strict)。用 Flexible 时回源仍是 http,WordPress 又跳 https,浏览器就会陷入循环,最终报 ERR_TOO_MANY_REDIRECTS。同理,服务器 301 生效后要停用 Really Simple SSL 一类插件的“强制 HTTPS”开关。
六、第五步:清理混合内容(含真实报错)
打开 F12 Console,典型报错长这样:
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS,
but requested an insecure element 'http://example.com/wp-content/uploads/2024/05/banner.jpg'.
This request has been blocked; the content must be served over HTTPS.
先定位来源,区分是数据库内容还是主题插件硬编码:
grep -rn 'http://example.com' wp-content/themes/ wp-content/plugins/ | head -50
wp db query "SELECT ID, post_title FROM wp_posts WHERE post_content LIKE '%http://example.com%' LIMIT 20;"
数据库内容用 WP-CLI 定向修复,比全库再跑一遍更安全:
wp search-replace 'http://example.com' 'https://example.com'
--all-tables --precise
--include-columns=post_content,post_excerpt
主题或插件里硬编码的地址只能改代码。作为过渡手段,可以加一条 CSP 让浏览器自动升级请求:
add_header Content-Security-Policy upgrade-insecure-requests always;
确认 Console 已无红色报错后,再开启 HSTS:
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
警告:不要随手加 preload 并提交到浏览器预加载列表,该操作不可逆,一旦某个子域没有证书,用户将无法通过“继续访问”绕过拦截。
七、方案对比与证书选型
四种常见的强制 HTTPS 与迁移落地方式对比:
| 方案 | 配置位置 | 性能开销 | 可控性 | 主要风险 |
|---|---|---|---|---|
| Nginx / Apache 301 | 服务器配置 | 最低,不经过 PHP | 高 | 需要 root 或面板权限 |
| WordPress 插件 | wp_options + PHP | 每次请求都跑 PHP 与数据库 | 中 | 与服务器规则叠加,触发重定向循环 |
| CDN 页面规则 | Cloudflare 等边缘节点 | 极低 | 中 | Flexible 模式回源仍是 http |
| wp-config 常量 | PHP 配置文件 | 低 | 高,可紧急回滚 | 只约束 WordPress,静态文件不跳转 |
证书选型参考:
| 证书类型 | 有效期 | 验证方式 | 适用场景 |
|---|---|---|---|
| Let’s Encrypt(DV) | 90 天,自动续期 | HTTP-01 / DNS-01 | 绝大多数站点,首选 |
| 商业 DV | 最长 398 天 | DNS / 文件验证 | 需要固定有效期与 SLA |
| OV 组织验证 | 最长 398 天 | 人工核验企业资料 | 电商、B 端、金融 |
| 通配符证书 | 同 DV / OV | 仅 DNS-01 | 多子域、多站点网络 |
结论:普通 WordPress 站点用 Let’s Encrypt 通配符证书 + 服务器层 301 是成本最低、故障面最小的组合。商业证书的价值在合规与责任承担,不在加密强度——TLS 1.3 的加密算法对所有证书一视同仁。
八、常见错误排查(真实报错对照)
1. ERR_TOO_MANY_REDIRECTS
排查:curl -sIL http://example.com | grep -i location,看 Location 是否在 http 与 https 之间来回跳。高频组合是 CDN Flexible 模式 + 插件强制 SSL + 服务器 301 三者并存。
2. curl: (60) SSL certificate problem: unable to get local issuer certificate
原因:ssl_certificate 指向了 cert.pem,缺少中间证书。改成 fullchain.pem 后执行 nginx -t && systemctl reload nginx。
3. 登录后立刻被踢出、跳回 http
原因:home 与 siteurl 不一致,或 wp-config 常量与数据库值冲突。执行 wp option get home; wp option get siteurl;,两个值必须完全一致。
4. Cloudflare 526 Invalid SSL certificate
原因:Full (strict) 模式下源站证书已过期或域名不匹配。用 openssl x509 -noout -dates -subject 核对源站证书的到期时间与 CN/SAN。
5. Error: This does not seem to be a WordPress installation.
原因:WP-CLI 在错误目录执行。加路径参数:wp --path=/var/www/html option get home。
6. 迁移后排版错乱、小工具消失
原因:之前用 SQL REPLACE() 破坏了序列化数据。从备份恢复后,改用 wp search-replace --precise 重做,不要试图手工修补长度前缀。
九、效果验证与收录迁移
上线前跑一遍验收脚本,四条全部符合预期再提交 sitemap:
curl -sI https://example.com | head -1
curl -sI http://example.com | grep -i '^location'
wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_content LIKE '%http://example.com%';"
wp option get home; wp option get siteurl
期望结果:第一条返回 HTTP/2 200,第二条返回 Location: https://example.com/,第三条返回 0,后两条输出完全一致。
收录侧动作:
- Search Console 优先添加“网域”资源(DNS TXT 验证),一次覆盖 http/https 与 www/非 www 四种组合;也可添加
https://example.com的 URL 前缀资源。 - 重新生成并提交 sitemap:Yoast 为
/sitemap_index.xml,Rank Math 为/sitemap.xml,WordPress 5.5+ 内置为/wp-sitemap.xml。 - robots.txt 中的
Sitemap:行同步改成 https 地址,否则爬虫仍会抓旧入口。 - 用“网址检查”对首页和 3-5 个核心页面手动请求编入索引,加快重新抓取。
- 保留 http → https 的 301 至少一年,Google 官方建议长期保留,旧外链和邮件里的链接都依赖它。
注意:同域名下的协议变更(http 换 https)不需要使用 Search Console 的“更改地址”工具,那是换域名才用的功能。也不要因为短期排名波动就回滚到 http,来回切换的伤害远大于耐心等待。
常见问题
至少保留 1 年,Google 官方建议长期保留。旧外链、RSS 阅读器、邮件和社交平台里的链接都指向 http,撤掉 301 会立刻产生大量 404,已传递的权重也会中断。服务器层 301 几乎零成本,没有删除的理由。
不加时按普通字符串替换,序列化字符串的长度前缀不会更新,unserialize() 会失败。表现为主题选项丢失、小工具消失、页面构建器排版错乱。正确做法是先加 –dry-run 与 –precise 看报告,确认无误再正式执行。
在 wp-config.php 中临时加入 WP_HOME 与 WP_SITEURL 两个常量,指向原来的 http 地址即可抢回后台,因为常量优先级高于数据库。修好证书后再改回 https,或直接删掉这两行让数据库值生效。
有效期 90 天,Certbot 安装时会自动写入 systemd timer 或 cron,默认在到期前 30 天续期。用 sudo certbot renew –dry-run 验证续期链路,再用 systemctl list-timers | grep certbot 确认定时任务确实存在。
短期波动正常。搜索引擎需要重新抓取并合并 http 与 https 两套 URL 的信号,通常 2-8 周趋于稳定。期间确保 301 正常、sitemap 已提交、无混合内容报错。持续下降超过两个月再排查跳转链和 canonical 配置。
不建议。两者叠加在反向代理或 CDN Flexible 模式下极易产生无限重定向,浏览器报 ERR_TOO_MANY_REDIRECTS。正确做法是只保留服务器层或 CDN 边缘的 301,把 Really Simple SSL 一类插件的强制跳转选项关闭。