GitHub Repo
LangChain Core 1.8.2、構造スキーマ作成時の警告フィルター競合を修正
LangChainは11月17日、動的スキーマの作成時に他のスレッドの警告を取り込んでしまう可能性がある問題を修正した langchain-core 1.8.2 を公開した。修正は正式パッケージに含まれているが、対象範囲は限定的で、Pythonのバージョンや警告設定に応じた検証が引き続き必要だ。

LangChainは11月17日、スキーマ作成時の警告フィルター競合に対する修正を正式リリースに含めた langchain-core 1.8.2 を公開し、パッケージはPyPIでも提供されている。同一プロセス内で複数のエージェントやモデルのタスクを並行実行するサービスでは、この更新に注意したい。基盤となるデータ構造の作成時に使われる一時的な設定が、他のスレッドの診断メッセージに影響する可能性があるためだ。リリースノート、PyPIパッケージ
修正の説明によると、従来の動的フィールドスキーマおよび非v1ルートスキーマの作成処理では、無関係なスレッドの警告を取り込んでしまったり、別のスレッドが同時に追加した警告フィルターを破棄したりする可能性があった。新バージョンでは、model* フィールドを含む動的スキーマに既存の名前空間設定とフィールドの再マッピングを使い、すべての警告を一時的に無視する方式を廃止した。また、通常のルートスキーマでは不要な警告コンテキストの管理を省いた。修正提案
この問題の鍵は共有状態にある。Python公式ドキュメントによると、context_aware_warnings が偽の場合、catch_warnings はwarningsモジュールのグローバル属性を変更するため、並行利用は安全ではない。フラグが真の場合は、ContextVar を使ってフィルターの状態を保持する。この仕組みはPython 3.14で導入されたため、すべてのPython環境で同じ分離動作が得られると考えることはできない。Pythonの警告機構に関するドキュメント
エンジニアリング上の推論として、警告が隠されると、依存パッケージの非推奨化や実行時の異常を示す早期の兆候をチームが見落とし、アップグレードやデバッグが難しくなるおそれがある。デプロイチームは実際に使用するPython環境で、動的スキーマの作成と、別スレッドからの識別可能な警告の発生を同時に行い、メッセージとフィルター規則が保持されるか確認できる。これはモデル呼び出しの成功だけを確認するより、修正の目的に即した検証となる。
今回の修正では、v1ルートスキーマとの互換性に必要な意図的な抑制は維持され、その他の非推奨警告のケースも対象外となっている。公式情報では、実際のデプロイで影響を受ける割合は定量化されていない。エンジニアはこの修正を、特定の並行診断経路を対象とするものとして捉え、ほかの警告処理フローにも調整が必要か、今後も確認するとよい。修正範囲の説明