LangChain 定制测试：组件契约、回调与完整链路

LangChain 的组件单测通过后，回调顺序、配置透传和重试组合仍可能出问题。测试需要从自定义组件延伸到模型客户端、检索器和完整链路。

先界定问题

先列清自定义组件接收的输入、输出与异常语义，再确认框架在同步、异步和流式路径中如何调用它。关键控制点应有明确接口，不能依赖隐式回调顺序。

处理与验证

保留框架提供的便利，收回关键控制权。先从边界最清楚的环节下手，例如输入校验、超时、日志或模型客户端；不必为了“底层化”一次性重写全部组件。

组件测试固定输入与配置，覆盖正常返回、空检索、模型超时和回调异常，并分别走同步、异步与流式入口。完整链路只保留少量代表任务，检查配置有没有透传、回调顺序是否可解释、重试是否重复触发副作用。

缺陷记录需要指出框架版本、组件配置、触发入口和实际回调序列。先在自定义组件的契约测试里复现，再跑框架集成；若必须依赖隐式顺序才能通过，应把该控制点收回到显式代码，而不是继续增加 mock。