成长阶段说明：从会写接口到能验证、能讲清楚

“学过”很难判断进度，“能交付什么”更容易核对。下面的阶段描述一件事从理解到完成的过程，不按工作年限划分。你可能已经能写接口，却还没查过一次事务失败；也可能项目做过不少，只缺一份清楚的表达。找到当前缺的材料，补这一段即可。

现在能拿出什么	从哪里继续
还不能独立运行程序或解释接口的输入输出	基础准备，先做一个小接口
项目可以启动，但说不清请求如何经过认证和数据库	阶段一，沿请求链跑通
能解释现有代码，但没有自己的改动	阶段二，做一个范围明确的改动
正常输入可以成功，失败分支没有记录	阶段三，补边界验收
有代码和验收记录，讲解却只剩组件名称	阶段四，整理表达与追问

基础准备：先写出一个小接口

适合零基础或基础断层的读者。先学 Java 的类型、控制流、方法、类、集合和异常，再练 HTTP、SQL 与 Spring Boot；这些内容可能需要较长时间，不用挤进三条目标路线的周数。

• 阅读： Java 基础、集合框架与Spring Boot。题目用于指出知识点；看不懂术语时先补概念和小程序，再回来回答。
• 任务： 先写一个命令行待办清单，能新增、列出、删除；再把其中一个操作做成 HTTP 接口，用本地数据库保存，并通过 Git 留下改动。
• 产物： 能运行的程序、启动步骤、一条正常请求、一条非法输入及对应结果。
• 检查点： 从空目录或新的练习副本按步骤能再次运行；能解释对象如何保存、异常在哪里处理、SQL 操作哪条数据。
• 卡住怎么办： 一次只处理一个问题。语法不熟就先回到命令行程序；接口失败先打印输入并检查状态码；数据库失败先单独执行 SQL。把第一条错误、预期和实际记下来，按帮助页整理问题。

阶段一：沿着一条请求跑通项目

• 阅读： 知识库服务和首次运行教程；已有项目也可使用自己的启动说明和接口文档。
• 任务： 在本地启动服务，完成登录、查看身份、创建文档和检索，再沿接口找到认证、业务逻辑与数据库访问位置。
• 产物： 环境卡、可复制请求、实际响应和一张请求调用图。保留必要的脱敏信息，令牌不写进共享记录。
• 检查点： 能说明登录身份从哪里来、数据存在哪里、引用对应哪份当前文档；知道健康检查成功还不能说明业务链路正确。
• 卡住怎么办： 先确认 JDK、Maven、端口与工作目录，再逐个调用接口。知识服务先用不需要模型密钥的默认模式；不要同时排查数据库、向量库和模型三个新依赖。

阶段二：做一项自己能负责的改动

• 阅读： 选题对应的工程指南及相关实现；知识服务可从文档更新与删除理解边界，再对照包内 Knowledge.java。
• 任务： 从一个可重复的问题出发，先保存原行为，再改一处实现。例如在自己的练习副本增加一类输入校验，或给检索流程补充能定位失败的脱敏记录。事先写清范围和预期。
• 产物： 原问题、改动说明、代码差异或提交、改动前后同一输入的结果。
• 检查点： 能区分项目原有能力和本人新增能力，并解释为什么这样改；改完后原本可用的正常请求仍然可用。
• 卡住怎么办： 把需求缩到一条接口、一种输入或一条日志。先读懂调用路径再改；若仍不能解释原行为，回到阶段一，暂时不增加新组件。

阶段三：让失败也有可核对的结果

• 阅读： 检索验收手册的环境卡和空白记录、RAG 故障排查。普通后端项目可以照用“输入、预期、实际、证据”的记录方式。
• 任务： 对自己的改动补一个正常场景、一个非法或无权限场景、一个状态变化场景。知识服务可检查更新、删除和旧版本冲突；已接外部依赖再增加故障用例。
• 产物： 逐项记录、原始响应、失败分类与复跑结果；未执行项单独列出原因。
• 检查点： 不靠记忆判定通过；同一身份、同一数据版本下能够复跑。检索无命中、依赖错误、权限拒绝有各自的证据，不能混成一个“失败”。
• 卡住怎么办： 只保留一份文档、一个身份和一个问题，找出第一处与预期不同的地方。缺日志就补记录；缺模型密钥就先验收本地检索，把真实模型与生成留作待验证项。

阶段四：把事实讲成一段项目经历

• 阅读： 项目表达、项目故事与证据及项目简历指南。
• 任务： 选一项本人完成的改动，用“问题、实现、验证、限制”写一条描述，再录一分钟介绍和三分钟请求链讲解；回答一次关于失败与取舍的追问。
• 产物： 职责表、证据索引、一条描述、录音或提纲，以及一个下一次补做的任务。
• 检查点： 每个动作能对应到自己的代码或记录，每个数字能交代测量条件；个人练习、协作工作和阅读理解都按实际说明。
• 卡住怎么办： 先对着代码讲一条请求，再删去讲不清的名词。没有性能测量就写功能与验证方法；没有个人实现就如实写复现或学习记录。

三条路线怎样使用这些阶段

Java 面试围绕知识缺口反复走“阅读、小实验、边界检查、讲解”；Java 转 AI以知识服务逐层积累运行和验收材料；项目到简历通常从阶段三、四开始，发现证据不足再回去补实现。

阶段完成不以阅读量或页面勾选为准。能重跑、能定位失败、能说明自己的贡献，就有了进入下一步的依据。回到成长路线首页选择当前目标。