PHP调试总卡壳？3步精准定位90%技术隐藏Bug
|
去年4月，那个周五下午三点十七分，我盯着屏幕右下角的系统时间——不是看它准不准，是看它卡不卡。Chrome DevTools 的 XHR 面板里，第三个请求一直挂在那里，转圈圈，状态栏显示“pending”，可 Network 面板又没发包记录，连 curl -v 都没响应。我原以为是 nginx upstream timeout 被改了，结果翻完 /etc/nginx/conf.d/ 下全部 include 文件，发现压根没 reload 过。对，就那么晾着。 显示器左上角贴着张便签：「PHP-FPM slowlog 已开，但日志路径写错两回，第三回才对」——字是实习生写的，蓝圆珠笔，力道不均，最后一横拖得老长。他后来被调去配测试环境，再没见过。我那天其实想把便签撕了，但手悬在半空停了十八秒，没动。旁边工位老张正用手机录屏，一边点 xdebug.profiler_enable=1，一边念叨：“你这 config 是抄的哪个年代的模板？”我没回，因为他说对了。真对了。
文章配图，仅供参考 第一步，不加断点，只改 php.ini：error_log = /tmp/php-debug-err.log，log_errors = On，display_errors = Off。然后 curl 一把，grep “Fatal error”；第二步，找那个在 CLI 模式下跑得飞起、但在 FPM 下死活不抛 Exception 的 ClassLoader，不是 autoload，是那个自定义的 require_once 逻辑链——它在 opcache 缓存命中时绕过 spl_autoload_register，直接读文件；第三步？第三步根本不是技术动作，是删掉 vendor/composer/autoload_static.php 里第 412 行那个 if (defined('TESTING')) return false; 注释掉它，跑一遍 php -d opcache.enable=0 index.php，bug 就出来了。90%？我敢打包票——去年 Q2 复盘会后我们拉了十九个线上报错单，十六个是这三步里的某一步就能戳穿的。剩下三个，一个死在 libxml2 版本差异，一个卡在 strtr() 第二参数传了 null 而非空数组（PHP 8.1 后静默变空字符串），还有一个……算了，那是个运维同事自己写的 supervisord 启动脚本里硬编码了 /usr/local/bin/php7.4，而服务器上只剩 php8.2，这个不算 PHP 调试范畴，算仪式性埋雷。审稿间的灯是声控的，亮三分钟自动灭，我第三次进去拿《Xdebug 3.2 官方 changelog》PDF 打印件时，灯又灭了。黑暗里听见隔壁组有人喊“谁动我 .bash_history”，然后是一串快速敲击键盘的声音，嗒嗒嗒，很轻，像雨打窗台。我没应。这种事应了就是接招，接招就得解释，一解释就破相——你知道为什么吗？因为只要开始解释，你就默认自己站在“要让人懂”的立场，而真内行从不听解释，只看有没有改过 opcache.revalidate_freq 或者 /etc/php//fpm/pool.d/www.conf 里是否漏写了 env[HOSTNAME]。 凉掉的外卖在左手边：黄焖鸡米饭，汤凝成浅褐色膜，盖子边缘结了一圈白霜似的脂粒。我拿筷子戳了一下，没戳透。这个细节跟定位 bug 毫无关系，但我就是记得它。还有一次，凌晨两点收到领导发来的六十秒语音，开头第一句是：“你们现在搞的那个 debug 流程，能不能……别再让 QA 在钉钉群里 @ 所有人问 ‘500 是哪层崩的’？” 语音结尾有隐约的咳嗽声，像是刚从会议室出来，含着半口没咽下去的咖啡。我没回，把语音转文字后截图发给了前端小陈——他三天前在 Vue 里手写了个 try-catch 包住 axios 请求，然后 console.error(e) 之后加了一句 throw e，却忘了加 catch，导致错误吞得比 PHP 还干净。这事我后来就没再提过，因为太常见，提了显得自己没经验。 我原以为第三步最管用，结果发现反而是第一步——error_log 那条路——筛掉最多假阳性。真正卡壳的，从来不是代码本身，是人总想“先加断点看看”，而不是先看 log 是否真的在写。xdebug.log 写到 /dev/null 是去年最常见的部署错误，但我们没人查，因为所有人都盯着 IDE 右下角那个绿色虫子图标。虫子在动，人就安心，哪怕它只是在重连 socket。这个我说不准，可能是习惯，也可能是肌肉记忆失效。不过话说回来，当你的 xdebug.client_host 是 docker0 网关地址而宿主机防火墙开着，虫子当然连不上——但它还是在动，动得特别有诚意。 上周五下午四点，我在公司楼下看见那个实习生拎着行李箱等网约车，箱子轮子有点歪，走起来哐啷哐啷响。他朝我抬手晃了晃手机，没说话，屏幕上是钉钉消息列表，顶部红点未读。我没过去，怕他说“哥，那个 slowlog 路径……是不是得加 /var/log/php/ 前缀？” 我不敢答，因为那一刻我突然想起，我自己第一次上线改 php.ini，也是加错路径，把 error_log 写成 /var/log/php/error.log 而不是 /var/log/php-fpm/error.log，结果三天都没看到一条 fatal——所有错误都落进了 /var/log/syslog 的杂音里，被 rsyslog 吞得连渣都不剩。 印刷对接的电话是昨天打的，催校样。我说：“封面标题再调一次，‘3步精准定位’后面那个顿号，换成逗号。” 对方说：“可上次校样你签的字……” 我打断他：“换。” 他沉默两秒：“行。” 挂之前我听见他那边打印机正在出纸，沙沙沙，很密，不像打印，像在磨刀。 现在的问题不是三步能不能定位 Bug，而是——当 devtools 的 debugger; 语句在 eval() 里，且 eval 是通过 unserialize() 触发的字符串执行时，你该信哪一层的 stack trace？我不打算答。今晚回去，先重装一遍 xdebug，不用 pecl，就用源码编译，顺手把 configure 里的 --enable-xdebug-profiler 改成 --disable-xdebug-profiler。别的，等明早再说。 （编辑：站长网） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |
