老陈自留地

欢迎来到:老陈自留地

老陈自留地
emlog 主题预览链接 ?theme= 报 502 Bad Gateway 的排查与修复
老陈自留地
老陈自留地

静水流深,岁月可期

返回文章列表

emlog 主题预览链接 ?theme= 报 502 Bad Gateway 的排查与修复

108 次阅读
约 7 分钟
AI 文章摘要

一、现象

站点用 Nginx / OpenResty 反代 PHP(1Panel 容器、宝塔都一样),访问带主题预览参数的地址:

https://example.com/?theme=lcbk-stationery

浏览器直接吐 502 Bad Gateway。但去掉 ?theme= 访问首页一切正常,PHP 错误日志、emlog 日志里干干净净,容器也没重启记录。第一反应往往是「PHP 崩了」或者「伪静态出问题了」,方向全错。

二、先看响应头,别急着翻日志

502 是网关吐的,不是 PHP 吐的。用 curl 把响应头拉出来数一下:

curl -sL -D - -o /dev/null "https://example.com/?theme=lcbk-stationery" | grep -ci 'set-cookie: *emlog_theme'

出问题的站上,这个数字是几十到几百。也就是说 PHP 正常执行完了,但它在一次响应里塞了几百行一模一样的:

Set-Cookie: emlog_theme=lcbk-stationery; expires=...; Max-Age=86400; path=/

Nginx 反代读上游响应头是有缓冲上限的(proxy_buffer_size),头部总量超了就直接判定上游异常,回 502,错误日志里通常只留一句 upstream sent too big header。PHP 侧毫无异常,所以日志干净 —— 这就是为什么这个故障看起来跟 PHP 无关。

注意 -L 不能省。如果域名有 301(比如裸域跳 www),不加 -L 只会拿到跳转响应,grep 结果是 0,你会误判成「没问题」。先确认探针拿到了 200,再谈数量。

三、根因:setcookie() 不会更新 $_COOKIE

问题出在核心文件 include/service/template.php 的 getCurrentTemplate():

$themeCookieName = 'emlog_theme';
$theme = Input::getStrVar('theme');

if ($theme && preg_match('/^[\w\-]+$/', $theme)) {
    setcookie($themeCookieName, $theme, time() + 86400, '/');
    return $theme;
}

三个事实凑在一起就炸了:

  1. setcookie() 只是往响应头里追加一行,它不修改当前请求的 $_COOKIE。 $_COOKIE 是请求进来时解析好的快照,本次请求内不会变。
  2. 这个函数在一次渲染里被调用非常多次。 init.php 里定义 TEMPLATE_URL、TEMPLATE_PATH 各调一次;装了模板设置插件后,主题里每一个 _g('xxx') 都会走 TplOptions::getTemplateOptions() → Template::getCurrentTemplate()。一个首页取上百个设置项,就是上百次调用。
  3. 只要 URL 上挂着 ?theme=,每一次调用都命中上面那个 if,于是每次都新发一行 Set-Cookie。

不带 ?theme= 时走的是 cookie 分支,不发头,所以首页正常 —— 故障只在预览链接上出现,也是它容易被误判的原因。

四、修改方法

编辑 include/service/template.php,把上面那段 if 换成:

if ($theme && preg_match('/^[\w\-]+$/', $theme)) {
    if (!isset($_COOKIE[$themeCookieName]) || $_COOKIE[$themeCookieName] !== $theme) {
        setcookie($themeCookieName, $theme, time() + 86400, '/');
        $_COOKIE[$themeCookieName] = $theme;
    }
    return $theme;
}

$_COOKIE[$themeCookieName] = $theme; 这行写回是整个补丁的关键,绝对不能省。 只加外层判断不写回,$_COOKIE 在本次请求里永远是空/旧值,判断永远成立,几百行 Set-Cookie 一行不少 —— 改了等于没改,还会让你以为「补丁无效」而往别的方向排查。

加上写回后,本次请求内第一次调用发一个 Cookie,后续调用全部命中 === $theme 直接跳过。

让它真正生效

  1. 改之前先备份:cp template.php template.php.bak。
  2. 改完重启 PHP 容器 / PHP-FPM。OPcache 会缓存旧字节码,不重启的话文件改了、行为不变,看起来就像补丁没起作用。
  3. 再跑一次第二步那条 curl,数量应该降到 0~2(init.php 调两次,个别版本会留下 2 行,属正常),页面返回 200。

五、不想改核心文件?关掉主题切换

?theme= 预览是由 config.php 里的开关控制的:

if (!defined('SWITCH_TEMPLATE')) define('SWITCH_TEMPLATE', true);

把 true 改成 false,getCurrentTemplate() 会直接返回后台设置的主题,压根不走 setcookie 分支,502 立刻消失。代价是失去前台主题预览能力。如果你只是自己开发时用预览,可以本地开着、线上关掉;如果线上必须保留预览,就用第四节的核心补丁。

六、每次 emlog 升级后都要复查

这是改核心文件的通病:升级会覆盖 include/service/template.php,补丁被静默冲掉,502 原地复活,而且往往在你升级完几天后点预览链接才发现。

把这条一行巡检记下来,升级后顺手跑一次:

curl -sL -D - -o /dev/null "https://example.com/?theme=你的主题目录名" | grep -ci 'set-cookie: *emlog_theme'

0~2 = 补丁还在;几十上百 = 已被覆盖,重新打一遍并重启 PHP。

另外,事故期间在 OpenResty 里调大的 proxy_buffer_size 建议留着当保险 —— 它不解决重复头的问题,但能抬高网关的容忍阈值,避免别的插件重复发头时再次 502。

七、小结

环节 要点
定位 502 先看响应头数量,不要先翻 PHP 日志
根因 setcookie() 不写回 $_COOKIE + 函数被高频调用
修复 加去重判断,并写回 $_COOKIE
生效 重启 PHP / 容器,清掉 OPcache 旧字节码
长期 升级会覆盖核心,升级后跑一行 curl 复查
1 条留言
AI 读者
AI 读者 10 天前
502错误其实是Nginx反代问题,而非PHP错误,检查响应头数量是关键。
访客名片(邮箱用于拉取头像)