先做最小复现，再决定采用哪种修复方式

前端排错还要关注用户感知，而不是只看控制台有没有报错。页面可能没有红色错误提示，却存在闪烁、旧数据短暂出现、按钮重复提交和加载状态卡住等体验问题。每一次状态变化都应该有合理的起🎇点和终点，用户才能判断当前操作是否已经生效。

《千鹤酱开发日记》这次排查留下的最大收获，是把“偶发 bug”转化成了可描述的工程问题。以后遇到列表内容不稳定，我会先确认请求是否并发，再确认响应是否按发起顺序返回，最后检查🎉页面状态是否允许旧数据写入。

开发记录不需要写成复杂报告，但至少要保存复现步骤、预期结果、实际结果、关键日志和修复边界。缺少💯这些信息时⭐，团队成员只能凭感觉重复点击；拥有这些信息后，任何人都能按照同样条件验证问题是否存在。

修复一个 bug 后，必须验证用户真正看到的结果

《千鹤酱开发日记》里最费时间的故障，是用户先搜索“咖啡”，随后马上改成“茶”，页面却偶尔显示“咖啡”的结果。开发环境中的✨网络速度比较稳定，问题很难出现；当网络延迟出现变化时，异常才会被放大。

我在本次记录中优先使用请求编号，因为该方案不会改变接口行为，也不依赖特定网络库。每次发起请求时保存当前编号，响应返回后比较编号；编号较旧的结果只记🌟录日志，不进入页面状态。这样既保留了异常信息，也避免过期数据污染界面。

把一次排查沉淀成下一次开发的检查表

千鹤酱项目今天的开发目标不是继续增加功能，而是把已有的消息列表整理成可观察、可测试、可维护的模块。页面目前包含搜索框、分类筛选、💯分页🌅按钮和自动刷新四个入口，每个入口都可能触发数据请求。如果所有操作都直接调用同一个加载函数，短期内代码看起来很简洁，后续排查却会十分困难。

千鹤酱项目的最小复现只保留搜索输入、请求函数和结果列表三个部分，移除了自动刷新、分页和复杂动画。缩小范围后，异常从“偶尔发生”变成了可以稳定触发：连续输入两个关键词，并人为让第一个请求延迟返回。

《千鹤酱开发日记》里的第一个异常：列表总是慢一拍

我先把消息列表拆成四类状态：等待加载、加载成功、加载失败和无匹配结果。每类状态都对应明确的页面表现，避免用一个布尔值同时表示“正在请求”和“列表为空”。状态名称越清晰，日志越容易阅读，后续测试也越容易覆盖。

千鹤酱项目今天先解决“能运行”之外的问题

《千鹤酱开发日记》今天记录🌟的核心结论很简单：一个看似偶发的 bug，通常不是靠反复点击就能解决，而是要先稳定复现，再缩小影响范围，最后验证修复是否真正覆盖了异常路径。今天遇到的问题发生在消息列表刷新时，页面偶尔会显示旧内容，重新打开页面又恢复正常。

问题表面像是接口返回错误，实际原因却出在异步请求完成顺序和页面状态更新之间。千鹤酱项目这次排查没有直接修改接口，而是把请求参数、响应时间、组件状态和渲染结果逐项记录下来，最终确认是旧请求覆盖了新请求的结果。