系列第17篇 | 一个bug不可怕三个同时来才致命凌晨4点的飞书2026年7月17日凌晨4点。我睡不着打开飞书看了一眼小密我的AI统筹Agent的消息。然后我愣住了【小密统筹报告 07-17 04:04】 【小密统筹报告 07-17 04:34】 【小密统筹报告 07-17 05:04】 【小密统筹报告 07-17 05:34】 【小密统筹报告 07-17 06:04】 【小密统筹报告 07-17 06:34】 【小密统筹报告 07-17 07:04】7条消息每条都只有一个标题没有任何内容。没有任务表格没有进度没有状态。就像一个员工每半小时给你发一封邮件标题写工作汇报打开里面是空白的。他没在偷懒——他一直在发邮件。但他也没在工作——邮件里什么都没有。我发了条消息“有什么问题一直在空转。”然后我开始排查发现不是一个bug是三个。它们来自三个完全不同的系统层互相不知道对方的存在但效果叠加在一起——整个心跳系统假装工作了整整5个小时。第一个炸弹空报告现象心跳每30分钟发一条报告到飞书从凌晨2点开始正常4点开始变成只有标题的空消息。排查过程我打开format_report.py看到了这个函数defhas_content(notes,timeout_tasks):ifnotes:# ← 问题在这里returnTrueiftimeout_tasks:returnTruereturnFalse看起来没毛病但问题在于notes里装了什么。当所有任务都处理完了脚本会往notes里写一句无待复核任务。bool(无待复核任务)返回True所以has_content说有内容继续生成报告。但后面有个过滤器filtered_notes[nforninnotesifnotn.startswith(无)]无待复核任务以无开头被过滤掉了。filtered_notes变成空列表。但has_content看的是过滤前的notes不是过滤后的filtered_notes。就像你在厨房检查食材有没有过期但没检查做出来的菜有没有变质。最终效果脚本说有内容→生成报告→内容被过滤→只剩标题→发送空报告。修复defhas_content(notes,timeout_tasks):# 不再检查原始notes检查最终输出linesformat_lines(notes,timeout_tasks)content_lines[lforlinlinesifl.strip()andnotl.startswith(【)andnotl.startswith(|)]returnlen(content_lines)0教训判断有没有内容要在出口看输出不要在入口看输入。第二个炸弹手机白屏现象手机浏览器一片白控制台没报错Vue完全没渲染。排查过程第一层资源路径混乱。mobile/index.html引用了/assets/xxx.js但文件实际部署在/mobile/assets/下。浏览器请求404JS不加载Vue不启动。但这个修好后还有第二层——更隐蔽的。localStorage跨设备污染。我之前在PC端访问系统点了侧边栏折叠按钮。JS把状态存进localStoragelocalStorage.setItem(sidebarCollapsed,true)localStorage是按域名存储的跟设备无关。同一个域名nasioe.cc.cdPC端和手机端共享同一份localStorage。我用手机打开同一个域名浏览器读到sidebarCollapsed trueJS把侧边栏宽度设成60px。手机屏幕375px宽60px侧边栏主内容区布局全乱。你以为localStorage是本地的其实它是本域名的。就像你在家里的冰箱贴了一张今晚吃火锅的便条结果你出差住酒店酒店冰箱里也有一张同样的便条——因为你们用的是同一个美团账号。修复// 只在PC端恢复折叠状态if(window.innerWidth768){constsavedlocalStorage.getItem(sidebarCollapsed);if(savedtrue){sidebar.classList.add(collapsed);}}第三个炸弹CSS幽灵现象PC端侧边栏折叠按钮被遮挡折叠后菜单文字没隐藏。排查过程我grep了CSS找到了这段.sidebar.collapsed span:not(.menu-icon){display:none!important;}选择器匹配的是span:not(.menu-icon)——也就是隐藏非图标的span。但实际HTML是这样的ahref/dashboard.htmlclassmenu-itemspanclassmenu-icon/span数据看板!-- ← 文字直接在a里不在span里 --/a文字不在span里直接写在a标签里。CSS选择器根本匹配不到它。CSS不会报错。它只是静静地失效看着你的页面一团糟。就像你给门配了一把钥匙但门锁已经换了。钥匙插进去转不动但门看起来还是那扇门。修复.sidebar.collapsed a{font-size:0;/* 隐藏a内的文字 */}.sidebar.collapsed .menu-icon{font-size:18px;/* 强制显示图标 */}三个bug的完美风暴Bug影响持续时间空报告飞书消息全是空白标题5小时手机白屏手机端完全无法访问直到修复CSS幽灵PC端侧边栏折叠失效直到修复三个bug单独看都不致命。但叠加在一起空报告→用户看不到系统在干什么“一直在空转”手机白屏→移动端完全不可用CSS幽灵→PC端UI也有问题从用户视角看飞书里一串空消息手机打不开电脑侧边栏也是坏的。整个系统似乎瘫痪了。但实际上核心逻辑任务派发、Agent调度、心跳监控一直在正常运行。出问题的全是展示层。一个内部正常但外部表现异常的系统在用户眼里跟完全坏掉没有区别。三个教训1. 判断有没有内容要看最终输出has_content检查原始notes但notes在后面被过滤了。入口看到的和出口输出的不是同一回事。2. localStorage是域名级别的不是设备级别的多设备共用的Web应用UI状态必须考虑跨设备兼容。用window.innerWidth判断设备类型是最简单的方案。3. HTML结构改了CSS选择器必须同步grepCSS选择器是盲的——DOM结构变了选择器失效样式静默丢失。改HTML后第一件事grep所有引用该class的CSS文件。