核心结论

北京时间 9 月 22 日 7 时 56 分,LangChain 在 GitHub 发布 JS 集成包 @langchain/google 0.2.7。仓库发布记录的发布时间为 2026-09-21T23:56:43Z,对应北京时间 9 月 22 日当日,对比区间为 0.2.6 至 0.2.7。本次为常规补丁更新,核心变化只有 1 项:当 Node.js 客户端回退到应用默认凭证时,按提供方要求配置必需的 OAuth 授权域,修复隐式 ADC 路径下可能缺失授权域导致的调用失败。官方发布说明未提及新模型支持、性能基准、价格配额或许可证变更,MIT 许可维持不变。以上版本、时间与对比区间由官方仓库发布页直接确认;影响判断为编辑基于发布说明的解释。

变化细节

官方发布说明列出的修复为:Configure the required OAuth scopes when the Node.js client falls back to Application Default Credentials,对应合入为 pull request #11664 与提交 16c5a5e。官方将其归为 Patch Changes,共 1 项,未描述为新能力或性能优化。关联 pull request 的说明进一步明确:仅在 Node 客户端走应用默认凭证回退时补齐提供方必需的授权域,保留既有的 API 密钥、内联凭证、显式 Google 鉴权与自定义客户端路径不变,并补充回归覆盖与凭证门控的 Vertex AI 集成测试。以上条目为官方宣布内容,未经独立测试验证。

官方本次未列出新增模型支持、API 新事件、价格配额、性能基准、破坏性接口声明或许可证变更。与同仓库 9 月 22 日的 langchain@1.5.12 等其他包更新相比,本次只影响 @langchain/google 的 Node.js 鉴权路径,不涉及核心智能体回调或模型画像数据。编辑未将其扩大为功能发布或可用性承诺。

影响与适用范围

受影响对象为已使用或计划通过 @langchain/google 对接 Google 模型的 JS/TS 项目,特别是 Node.js 服务端以应用默认凭证访问 Vertex AI 或生成式语言接口的链路。修复后隐式 ADC 回退不再因缺失授权域被拒绝,有助于减少本地开发与云上部署间的鉴权排查。仅使用 API 密钥直调、Python 集成、其他 LangChain 伙伴包或 REST 直调的用户不受本次客户端更新影响。中国开发者可在官方仓库核对版本号与对比区间后评估升级,服务端模型与配额仍以账户实际开通为准。

限制与下一步

本次发布说明未提供基准性能、成功率或成本对比数据,不应理解为性能或成本承诺。鉴权修复的实际效果仍受服务端、网络、项目权限与凭证配置影响,补齐授权域不等同于对应服务端能力已对当前账户开放。关联测试中部分集成测试为凭证门控,在无 ADC 凭证环境下跳过。建议先在测试环境回归 Node.js 鉴权回退与现有调用链路,再全量升级。若后续出现补充说明或修复版本,将以新的可核验事件另行处理。