搬站那天晚上,我们把 rsync 跑完、把 Nginx 的 server_name 一改、把 DNS 的 A 记录指到新机器,用手机打开首页,正常。第二天上午同事发来一句「后台列表页"正在加载"转圈不出来」,我打开一看,浏览器控制台里一条红字:login.php:412 Mixed Content: The page at 'https://example.com/admin/' was loaded over HTTPS, but requested an insecure XMLHttpRequest endpoint 'http://example.com/admin/api.php'. This request has been blocked.
这条报错最让人困惑的地方在于:代码一行没改,数据库一模一样,域名也没换,只是换了服务器和证书,为什么就变成"混合内容"了?答案往往不在代码里,而在"内核头文件"这一层——PHP 和 Nginx 对"这个请求到底是不是 HTTPS"的判断,在旧机器上成立,在新机器上不成立。
这篇文章把这条链从头拆到尾:浏览器凭什么拦截、服务端凭什么误判、四种误判形态分别对应哪一行配置,以及上线前怎么用一条 grep 把全站混用的地方捞出来。全文只讨论一个具体现象,不讲泛泛的"全站 HTTPS 改造"。
一、浏览器只认一个判据:页面本身用什么协议取回来的
先把机制说清楚。现代浏览器对"混合内容"的判定非常简单粗暴:只要当前文档是通过 HTTPS 取回来的,那么它后续发起的所有子资源请求、XHR、fetch、iframe、WebSocket,只要协议是 http:,就直接拦截。它不看你的服务器有没有 80 到 443 的跳转,也不看你 Cookie 上有没有 Secure 标记,只看 URL 字面上的 scheme。
所以"我在 Nginx 里配了 301 跳转"这件事,对混合内容一点作用都没有。浏览器压根没把那个请求发出去,Nginx 没有任何机会做跳转。跳转只能解决"用户敲了 http 地址"的问题,解决不了"页面里写死了 http 地址"的问题。
更麻烦的是不同资源类型的处置力度不一样:
- 图片、音频、视频:早期浏览器会"自动升级"成 https 再试,很多站因此看起来"没坏",实际上只是被悄悄兜住了;
XMLHttpRequest与fetch:直接拦截,抛错,前端拿到的是一个失败的 Promise,控制台里清清楚楚写着 blocked;- 样式表与脚本:拦截且更严格,部分浏览器会在拦截后把整份 CORS 策略收紧;
- 表单 action 指向 http:提交时弹警告,或者提交后因为 Cookie 的 SameSite / Secure 组合而丢会话。
这就是"首页看起来正常、后台接口全挂"的典型成因:图片被自动升级保住了,XHR 没有这个待遇。
二、为什么服务端会生成 http:// 开头的地址
绝大多数 PHP 应用并不是"手写"了 http 前缀,而是在运行时"猜"当前页面的协议。这类代码到处都有,常见的几十种写法最后都落到同一处:
// 典型写法一
$scheme = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on') ? 'https' : 'http';
// 典型写法二
$scheme = $_SERVER['SERVER_PORT'] == 443 ? 'https' : 'http';
// 典型写法三
$base = 'http://' . $_SERVER['HTTP_HOST'];在"PHP 直接监听公网、或者由 Nginx 用 fastcgi_pass 直传"的架构里,这三种写法都能正常工作,因为 Nginx 会把 SSL 相关信息翻成 $_SERVER['HTTPS']=on 与 REQUEST_SCHEME 传下去。但只要中间多了一层——CDN、负载均衡、内网反向代理、Docker 端口映射——Nginx 看到的就变成了一个"来自内网的普通 HTTP 请求",上面那三个判据全部失效,应用于是老老实实拼出 http://。
顺带一提,$_SERVER['SERVER_PORT'] 这种写法比第一种更危险。前面有代理时它通常是 80,就算你把 Nginx 的 listen 改成 8080 也会跟着变,完全不可靠。判断协议永远应该读 HTTP_X_FORWARDED_PROTO 或 REQUEST_SCHEME,而不是端口号。
三、四种误判形态,对号入座
形态一:面板改了 SSL 开关,但没告诉 PHP
宝塔、AMH、aaPanel 这类面板在"一键部署 SSL"之后,会在站点配置里加上 listen 443 ssl 与 fastcgi_param HTTPS on。但如果你后来在面板里"重建"过一次站点、或者手动替换过 vhost 文件,这一行 fastcgi_param 很容易丢掉。判据非常直接:
grep -n 'fastcgi_param HTTPS\|fastcgi_param REQUEST_SCHEME' /usr/local/nginx/conf/vhost/example.com.conf没有任何输出,就是它。修复只需要在 location ~ \.php$ 块里补两行:
fastcgi_param HTTPS on;
fastcgi_param REQUEST_SCHEME https;注意必须写在 PHP location 内部,写在 server 块顶层是不生效的——fastcgi_param 只对 fastcgi 处理路径有意义,Nginx 不会替你把 server 级别的变量传进 fastcgi 参数表。
形态二:中间有一层反代或 CDN,忘了透传 X-Forwarded-Proto
这是最普遍的一种。浏览器到 CDN 是 HTTPS,CDN 回源是 HTTP,源站 Nginx 于是把请求当 HTTP 处理。如果源站是 Nginx 前面再套一层 Nginx(很常见的"443 终结机 + 后端应用机"结构),第一层必须显式传头:
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Port $server_port;
}只有 X-Forwarded-Proto 是浏览器/编辑器最容易漏的一条,因为它"看起来不影响功能"。但它恰恰是后端唯一能知道"用户侧其实是 HTTPS"的证据。
第二层(应用机)的 Nginx 也要配合,把它翻成 PHP 能读的变量:
map $http_x_forwarded_proto $real_scheme {
default $scheme;
https https;
http http;
}
server {
listen 8080;
location ~ \.php$ {
fastcgi_param HTTPS $real_scheme if_not_empty;
fastcgi_param REQUEST_SCHEME $real_scheme;
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}
}这里的 if_not_empty 是安全的:当 $real_scheme 取值为空时该参数不发送,PHP 拿到的就是默认的未定义,不会把 HTTPS 硬设成 http。老版本有人直接写 fastcgi_param HTTPS $http_x_forwarded_proto;,一旦头缺失就传了个空字符串,PHP 里 isset() 为 true 但值不是 on,逻辑会走到"既不是 https 也不是 http"的分支,更难查。
形态三:应用里有硬编码的站点 URL
前面两种是环境判断错,第三种是配置写死了。很多 CMS 在安装时把站点地址存进了数据库(Typecho 的 options 表、WordPress 的 wp_options 里那两条 siteurl / home),之后所有生成的链接都从那里取。搬站时如果 SQL 是整库导入的,这个值仍然是旧地址;如果旧地址是 http,全站的链接就是 http。
排查命令(以 Typecho 为例):
mysql -uroot -p zz1984 -e "SELECT name,value FROM typecho_options WHERE name IN ('siteUrl','rewrite')"看到 http:// 开头的值就改掉。别用 UPDATE 直接替换整张表,容易把正文里的正常链接也改掉;先 SELECT 出受影响的记录再逐条改。改完记得清一下 OPcache 或应用的配置缓存,否则页面还是旧的。
形态四:模板里写死了绝对地址
最隐蔽的一种。前三种修完,控制台还有零星几条 blocked,而且每次都是同一批资源。这时候问题的位置已经不是"服务端判断",而是"模板里真的写了 http"。
排查方式就是全文 grep,但要排除注释、README 和日志:
grep -rn --include='*.php' --include='*.html' --include='*.css' --include='*.js' \
-E "(src|href|url)\s*=\s*[\"']http://" /www/wwwroot/example.com \
| grep -v '://www.w3.org' | grep -v '/\.git/' | head -50顺手把 http://schemas、http://www.w3.org、http://purl.org 这类 XML 命名空间排除掉,它们不需要改,也不会触发混合内容(不是资源请求)。真正的病灶通常是:一份 CDN 库的 script 标签、几处没有协议的图片地址、还有编辑器粘贴进来的外链图片。
四、一个能扛住中间层的通用做法
如果站点是"多环境、多入口、随时可能加一层代理"的状态,与其每加一层就去补一次配置,不如在应用层做一次统一收敛。思路是:在公共入口文件最顶部、任何业务代码之前,插入十行代码,把所有"协议判断"集中到一处。
if (!empty($_SERVER['HTTP_X_FORWARDED_PROTO'])) {
$proto = strtolower(trim(explode(',', $_SERVER['HTTP_X_FORWARDED_PROTO'])[0]));
} elseif (!empty($_SERVER['HTTP_CF_VISITOR'])) {
$v = json_decode($_SERVER['HTTP_CF_VISITOR'], true);
$proto = (isset($v['scheme']) && $v['scheme'] === 'https') ? 'https' : 'http';
} elseif (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on') {
$proto = 'https';
} else {
$proto = 'http';
}
$_SERVER['HTTPS'] = ($proto === 'https') ? 'on' : '';
$_SERVER['REQUEST_SCHEME'] = $proto;
$_SERVER['SERVER_PORT'] = ($proto === 'https') ? '443' : '80';几个细节值得说:
X-Forwarded-Proto可能是一个逗号分隔的链(多级代理),只取第一个才是用户侧的真实协议,不要取最后一个;- 头的值由客户端可控,理论上可以被伪造。但如果站点本身在源站只接受来自代理的连接(限制源 IP 或用内网),风险可控;如果源站直接暴露公网,就要在 Nginx 层把这条头清掉再重设,不要让外部值透进来;
- 重写
SERVER_PORT看起来有点"野蛮",但大量老旧代码就是在读它,这是代价最小的一步。
这段代码的价值不在于它多精妙,而在于它把"协议判断"从散落的二十处收敛成一处。以后再加 CDN、再换架构,只需要看这十行。
五、上线前的三分钟核对动作
每次动过证书、CDN、反代配置之后,建议固定做这三件事,三分钟能做完:
# 1. 页面里有没有 http:// 的资源引用
curl -s https://example.com/ | grep -oE '(src|href)="http://[^"]+' | head -20
# 2. 服务端自己认为的协议
curl -s -H 'X-Forwarded-Proto: https' https://example.com/check.php | head
# 3. 用 http 访问时的跳转是否一步到位
curl -sI http://example.com/some/page.html | grep -iE '^(HTTP|Location)'第二条需要一个临时的诊断脚本,内容就是 var_dump($_SERVER['HTTPS'], $_SERVER['REQUEST_SCHEME'], $_SERVER['SERVER_PORT']);,用完立刻删。它比看代码猜要可靠得多——很多"明明配了"的情况,实际是配置落到了另一个 vhost 文件里。
第三条用来验证跳转链。理想的形态是一步跳到 https,中间不经过 www 与非 www 的二次跳转。如果看到两次 Location,说明跳转链多了一环,不仅慢,还会让 Cookie 在不同主机名下分裂。
六、几个容易踩的边角
HSTS 不是解药,是放大器。 有人遇到混合内容就去开 HSTS,结果是浏览器把 http 请求"自动升级"后再失败,报错从 Mixed Content 变成 ERR_SSL_PROTOCOL_ERROR,更难读。HSTS 要等全站真正统一后再开,并且一旦下发 max-age=31536000,在那一年内浏览器不会给你回头的机会。
Cookie 的 Secure 与 SameSite 要一起看。 混合内容修好之后,仍有用户反映"登录后一刷新就掉"。这时候要看会话 Cookie 是否带 Secure。HTTP 页面上服务端下发的带 Secure 的 Cookie 会被浏览器丢弃,表现为"登录接口返回成功,但下一次请求没带上 Cookie"。
CDN 的"协议跟随"设置会覆盖你的判断。 部分 CDN 支持"回源协议跟随"与"回源强制 HTTP"两个选项。前者会把用户协议传给源站(表现为 X-Forwarded-Proto 正确),后者则永远 HTTP 回源但可能顺带清了这条头。配置变更后一定要用 curl 回源看一下实际到达源站的请求头。
剪贴板里的外链图片。 如果站点有富文本编辑器,用户粘贴的图片可能是 http:// 的第三方图床地址。这类内容在编辑器里看着正常,上线后才在控制台报错。稳妥做法是在保存内容时做一次正则替换,把正文里的 http:// 资源地址统一写成相对路径或 https,并在替换前记录日志,避免误伤。
七、小结
混合内容这条报错看起来像"前端问题",实际上九成的根因在服务端的协议判断上。排查顺序应该是固定的:先确认页面本身是不是 https(看地址栏和 curl -sI),再确认 Nginx 有没有把 HTTPS 标记传给 PHP(grep fastcgi_param),再确认中间层有没有透传 X-Forwarded-Proto,最后才去模板里 grep 写死的地址。
顺序反过来做会浪费很多时间——先在模板里翻半小时,结果问题是 vhost 里少了三行。这个顺序的价值在于:前三步都是"一条命令出结果"的判断,只有第四步需要逐个文件看。
另外提醒一句:这类问题在新机器上暴露,不是"新机器有问题",而是"旧机器一直在悄悄兜着"。修复之后顺手把应用里的协议判断收敛成一段公共代码,下次搬站或加 CDN 时,就只需要改一处了。