LangChain 定制测试组件契约、回调与完整链路LangChain 的组件单测通过后回调顺序、配置透传和重试组合仍可能出问题。测试需要从自定义组件延伸到模型客户端、检索器和完整链路。先界定问题先列清自定义组件接收的输入、输出与异常语义再确认框架在同步、异步和流式路径中如何调用它。关键控制点应有明确接口不能依赖隐式回调顺序。处理与验证保留框架提供的便利收回关键控制权。先从边界最清楚的环节下手例如输入校验、超时、日志或模型客户端不必为了“底层化”一次性重写全部组件。组件测试固定输入与配置覆盖正常返回、空检索、模型超时和回调异常并分别走同步、异步与流式入口。完整链路只保留少量代表任务检查配置有没有透传、回调顺序是否可解释、重试是否重复触发副作用。缺陷记录需要指出框架版本、组件配置、触发入口和实际回调序列。先在自定义组件的契约测试里复现再跑框架集成若必须依赖隐式顺序才能通过应把该控制点收回到显式代码而不是继续增加 mock。