LangChain加载OpenAPI YAML遇ConfigError：ForwardRef未准备完成

问题核心原因 #

update_forward_refs()方法是原地修改对象，不会返回新的OpenAPISpec实例，所以你执行spec = spec.update_forward_refs()会把spec覆盖成None，导致后续报错。

正确操作步骤 #

按以下顺序执行代码即可解决问题：

from langchain.tools.openapi import OpenAPISpec

# 正常加载YAML文件
spec = OpenAPISpec.from_file("fruits.yaml")
# 直接调用update_forward_refs，不要赋值回spec
spec.update_forward_refs()
# 后续继续使用原spec对象进行操作

额外排查建议 #

如果执行后仍有问题：

• 检查你的OpenAPI YAML文件，确保所有$ref引用的Schema都已在文件中正确定义，无循环引用或未定义项
• 升级LangChain到最新稳定版本，旧版本可能存在ForwardRef处理的兼容性问题

内容的提问来源于stack exchange，提问作者Newbie