Part 1 重访代码调查基础

为什么从“基础调查证据梯”开始

Part 1 重访代码调查基础要解决的是先理解应用代码和正常行为，再决定调试器与日志的使用方式，避免从工具输出直接跳到根因。 直觉上，最后出现的异常、最热的方法和最大的对象都只是信号；根因必须解释正常与故障时间线的第一个分叉，并能让原反例在最小修复后稳定转为通过。

先预测：把代码熟悉度从“入口已知”切换到“依赖与状态已知”，行为解释度和工具先行偏差将怎样变化？运行前写下能推翻假设的观察，结果不符时修改假设而不是删除失败样本。

来源、版次与独立重写边界

Manning官方产品页确认 Laurențiu Spilcă《Troubleshooting Java》第2版于2025年10月出版、360页、ISBN 9781633435575，并公开4个Part、13章、附录A–F的完整目录；课程映射24个正式单元、138个目录节点，另设学习地图与总复习。本页未取得原书正文，完整目录只用于限定单元和小节范围，不宣称正文忠实。

本页机制以Oracle JDK 25故障排查指南、jcmd手册、JFR手册、VisualVM官方文档和OpenTelemetry Java文档中的适用部分独立核验。中文解释、命令组织、交互模型、练习与答案均为独立教学重写；工具文档许可证不被误报为原书授权。

本章术语与调查合同

、、、、、。

Part 1 重访代码调查基础必须守住“调查结论必须同时解释正常路径与故障路径的首个分叉”。代码熟悉度与动态证据是离散调查坐标，行为解释度和工具先行偏差分开报告；交互中的数值只表达透明因果方向，不是假装采集了真实生产指标。

官方目录逐项深读

Part 1 Revisiting the foundation for code investigation

四级证据 1/1。 Part 1 Revisiting the foundation for code investigation：分部页负责声明相邻章节共用的升级条件、证据接口和不可跨越的前置门禁。本节点以“入口”为焦点，运行git rev-parse HEAD && java --version或等价探针，保存原始输出、时间窗、扰动预算和适用边界。

验证 Part 1 Revisiting the foundation for code investigation 时，先预测它在 建立地图 阶段怎样改变行为解释度；随后只调整代码熟悉度或动态证据。若“没有正常基线就把第一个异常日志或断点值定义为根因”没有制造预期首错，就撤回当前假设并检查替代解释。

最小调查切片

git rev-parse HEAD
java --version
printenv | sort > environment.txt

Part 1 重访代码调查基础运行该切片时要固定主机、容器、进程、JDK、应用commit、配置、负载与时间窗；所有日志、JFR、线程转储和堆转储都写入受控目录并登记大小、哈希、权限和删除期限。命令失败或超出扰动预算时立即停止，不把半份工件包装成完整证据。

unit: jvt-2e-part-1-foundation
command: "git rev-parse HEAD && java --version"
baseline: frozen
fault: "没有正常基线就把第一个异常日志或断点值定义为根因"
invariant: "调查结论必须同时解释正常路径与故障路径的首个分叉"
replay: same_input_same_window

三个必须主动触发的误区

练习、答案与节点验证

术语复核与本章回顾

完成Part 1 重访代码调查基础意味着能说明先理解应用代码和正常行为，再决定调试器与日志的使用方式，避免从工具输出直接跳到根因。，能运行本章调查切片，能主动制造“没有正常基线就把第一个异常日志或断点值定义为根因”，还能用原始信号和反例证明修复而非只展示工具截图。