Lesson 09 · 排障
故障分诊：拿到报障，先判归属层
前八课每课都往分诊表里塞了几条。这一课把它们串成一套可以照着走的流程。
📋 这一课还没写正文，这是大纲
课 01–04 已经出正文，够你把项目跑起来、看懂一次请求、看懂页面和状态。
05–09 属于「能独立干活」阶段，需要几个真实的历史报障案例 ——
编出来的案例练不出分诊能力才能写得可靠。
下面的目录不是占位符 —— 每一条都已经在源码里核对过入口，
你现在就可以照着自己去读。
为什么排在这个位置
这是整个课程的终点，也是这个岗位的核心能力：别人给你一句模糊的描述，你能在十五分钟内给出带证据的根因。
排在最后，因为分诊靠的是前面所有课积累的「这个症状可能来自哪几层」的映射。没有那些积累，分诊表只是一张纸。
前置
- 课 01–08 全部
-
故障分诊表 ——
逐课累积的成果，这一课把它补完
会讲什么
-
分诊的第一问永远是「哪一层」。渲染 / 主进程 / 子进程 /
网络 / 外部服务 / 凭据 / 平台 —— 七个候选，先排除到两个以内
-
七层各自的第一检查点。每层给一条最快的判定动作，比如凭据层就是
JSON.parse(localStorage.getItem("GameENV"))
-
把模糊描述翻译成可检查的命题。「保存没反应」→「请求发出去了吗 / 打到哪台服 / 参数对吗 /
服务端返回了什么」
-
本项目特有的五个高频误判。按 URL 筛 Network（没用，要看
cmd）、以为菜单隐藏就是无权限、把「没选服」当成代码 bug、把
Mac 上的 exe 失败当成环境损坏、在 serviceold.ts 里改代码
-
静默失败的识别。本项目大量操作失败时不报错，「没有错误信息」本身是一条强信号
-
演练：三个真实案例。从一句话描述走到带
file:line 的根因
-
怎么写一份能交出去的排查结论。症状 / 复现步骤 / 归属层
/ 证据 / 根因 / 处置 / 是否需要他人配合
学完之后你应该能
- 拿到任何报障，能在十五分钟内判定归属层并给出下一步
- 能写出让别人（包括服务端、运维）看得懂并能接手的排查结论
- 知道什么时候该停下来问人，而不是继续自己查
- 有一张自己维护的分诊表，遇到新问题往里加
在正文出来之前，你可以先做这些
-
打开故障分诊表，看已经攒了哪些条目
-
开始记录。从今天起，每遇到一个自己卡住的问题就往表里加一行：症状、最后发现是哪层、下次最快的判定方式
- 把课 02 的「列表是空的」那张五步排查表读熟 —— 那是分诊的标准形态
-
向前任的同事收集历史报障。问「过去半年这个工具最常出什么问题」，这比任何文档都值钱
站点版本 319ca82 · 2026-08-13
内容基线 gameboxclient @ 2026-08-12