加入收藏 | 设为首页 | 会员中心 | 我要投稿 站长网 (https://www.52php.cn/)- 应用程序、AI行业应用、CDN、低代码、区块链!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

PHP调试总卡壳?3步定位90%隐藏Bug

发布时间:2026-11-16 15:02:16 所属栏目:PHP教程 来源:DaWei
导读:  前年那个活动站,老板指着旧站截图说“按钮要大一点”,设计把三个CTA全换成蓝底白字,前端照着切,我负责PHP后端逻辑——其实就三行:校验手机号、查用户是否已参与、写进Redis。上线前一小时,测试说“点不动”。不是报错,

  前年那个活动站,老板指着旧站截图说“按钮要大一点”,设计把三个CTA全换成蓝底白字,前端照着切,我负责PHP后端逻辑——其实就三行:校验手机号、查用户是否已参与、写进Redis。上线前一小时,测试说“点不动”。不是报错,不是500,是点完没反应。XHR状态200,响应体空,连个空数组都不返回。浏览器控制台安静得像会议室投影那道竖线,从左上角直直劈到右下角,晃眼,但没人关。


  我在本地搭了个临时环境,curl -X POST 直接打接口,返回 {"status":"ok"}。再 curl 一遍,还是 ok。我打开生产服务器的 error_log,grep "phone",grep "redis",grep "fatal",全是空白。日志里只有两条 warn:date_default_timezone_set() 重复调用,和一个被注释掉的 var_dump() 残留。我盯着那行残留看了两分钟,顺手删了——删完,第二天凌晨三点,线上又挂了。


  第一步:别信 request body,信 raw_input。那天凌晨三点,我扒着 Nginx access_log 看到 POST /join 的 UA 是微信内置浏览器,body 长度字段显示 47 字节,但 $_POST 是空的。file_get_contents('php://input') 打出来一看:{"phone":"1381234","source":"wechat"} ——JSON 格式,但 content-type 是 text/plain。框架没自动解析,$_POST 自然空。而前端传参代码在 activity-v2.3.js 第 89 行:fetch(url, {method:'POST', body:JSON.stringify(data)}),压根没设 headers。这个 bug 躺在上线 checklist 第 7 条“检查所有接口 content-type”下面,用红笔画了圈,旁边批注“确认过✅”,字是我自己写的。


  第二步:别追 echo,追 register_shutdown_function()。那个空响应,根本不是没走到 return,是走到了,但在 header() 之后、exit() 之前,Redis 连接突然 timeout,触发了 set_error_handler,但 error_handler 里又 try 了一次 redis->get(),第二次失败时触发了 fatal error。PHP 默认不把 fatal error 记进 error_log(尤其当它发生在 shutdown 阶段),你 echo 出来的那点东西早被 buffer 刷掉了。我在入口文件最顶上加了:register_shutdown_function(function(){ $e = error_get_last(); if($e && in_array($e['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) error_log(json_encode($e)); }); ——第二天日志里就躺了一行:{"type":1,"message":"Redis server went away","file":"/app/logic/join.php","line":42}。就是那行 $redis->get("user:$phone")。没人改过这行,但 Redis 实例那天半夜做了主从切换,新从库还没同步完数据。


文章配图,仅供参考

  第三步:别查代码,查 ini。出问题的机器是新配的云主机,PHP 版本 7.4.33,跟预发一模一样。我 diff 了 phpinfo(),唯一区别是 production 里 upload_max_filesize=2M,而 pre 是 8M。但这跟短信验证有啥关系?直到我发现:那段处理手机号的代码开头有句 if($_FILES) {...} ——原来有人半年前为兼容另一个需求,在通用入口函数里塞了个 $_FILES 判空,结果在没文件上传的请求里,PHP 会偷偷初始化 multipart parser,而 parser 在读取超长 header(比如微信 UA 带的 extra 参数)时,如果内存不足,会静默截断 input stream。那个空响应,其实是 parser 半路崩了,后面整个 request body 都喂给了黑洞。我把 post_max_size 从 8M 改成 16M,加了 memory_limit=256M,重启 PHP-FPM,凌晨四点二十一分,第一个有效响应回来了。


  桌上六瓶水只开了两瓶,其中一瓶是我拧开喝了一口就搁那儿了,另一瓶是外包测开的,他走时忘了盖盖子,现在水面浮着层细灰。笔记本电量剩百分之十几,我把它插上电,风扇转起来的声音比走廊里那人打电话还响——他一直在说“对对对我们今天必须上线”,语速快得像在抢夺什么倒计时。窗户被谁推开一半又关上,气流带进来一股樟脑丸味,可能楼道消杀刚过。


  没人吵架。老板当天下午就去出差了,设计在改首页动效,前端蹲在测试机前调安卓微信兼容性。我一个人对着 terminal 折腾了六小时,中间转笔的人是我自己,笔在指间转了三百多圈,停的时候笔尖已经磨秃了。你说这方法准不准?不一定。上个月有个 bug 是 nginx proxy_buffer_size 设太小,POST body 被截半,PHP 根本收不到完整 JSON,register_shutdown_function 也救不了。那回靠的是 tcpdump 抓包对比。所以这次这三步,只能保你先甩掉八成的幻觉,剩下的两成——得看运气,或者把监控探针埋深一点。


  我现在习惯在每个新项目入口文件第一行写上:ini_set('log_errors', '1'); ini_set('error_log', '/tmp/php-debug.log'); ——不是为 debug,是为以后骂自己时有据可查。下个项目,试试把 php-fpm 的 slowlog 开到 100ms,别等它真卡住才想起来看。或者,干脆把你本地 Xdebug 的 port 改成 9003,别再和 IDE 自动匹配的 9000 冲突了——上周我就因为这个,在 docker-compose.yml 里多写了三行 alias,搞丢两小时。

(编辑:站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!