跳到主要内容
Apache

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 一类插件的强制跳转选项关闭。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。