※この記事は、個人技術ブログ CodeArchPedia.com の技術メモ（要約）です。
データ分析を進めている最中に、突然 ImportError: cannot import name 'triu' from 'scipy.linalg' に出くわした。最初は関数名が変わっただけだろうと軽く考えていたが、gensim のような計算ライブラリが絡むと、依存関係の不整合という泥沼にはまることが多い。プロジェクトの安定稼働を考えると、この種のインポートエラーは早急に対処が必要だ。
何が起きたか（課題）
scipy のバージョンアップや、他のライブラリとの相性問題で、必要な線形代数関数が見つからなくなる事象に直面した。主な問題点は以下の通りだ。
- 特定のコードパスで
ImportError: cannot import name 'triu' from 'scipy.linalg'が発生する。 - 原因は、インストールされている
scipyのバージョンと、依存ライブラリ（特にgensim）が必要とするバージョンとの間に不整合があること。 - 環境が汚染されている場合、再インストールでも解決しないことがある。
どう解決したか（概要）
根本的な解決のためには、単にエラー行を修正するのではなく、依存関係全体を見直す必要があった。シニアエンジニアとして推奨するアプローチは、バージョンを最新かつ互換性のある組み合わせに揃え、仮想環境で管理を徹底することだ。
まず、使用中の仮想環境（venvやconda）内で、scipy と gensim の両方を最新版にアップグレードするコマンドを実行した。多くの場合、これで依存関係が解決に向かう。
pip install --upgrade scipy gensim
それでも解決しない、あるいは特定の安定版が必要な場合は、互換性が確認されているバージョンを特定し、requirements.txt で明示的に固定する必要がある。特に scipy のバージョン 1.10以降で関数の場所が変わっているケースが多いため、ドキュメントベースでの確認が重要になる。
さらに、この種の問題を再発させないために、Poetry や Pipenv といったモダンな依存関係管理ツールへの移行を強く推奨する。これにより、環境構築時の「依存関係地獄」を根本から排除できる。
効果（Before/After）
依存関係を最新かつクリーンな仮想環境で管理した結果、ImportError は完全に解消された。開発チーム内での環境構築の差異がなくなり、デプロイ時の予期せぬエラーが激減したことが最大の効果だ。ライブラリのバージョンを固定し、ロックファイル（例: Pipfile.lock）をコミットすることで、再現性が大幅に向上した。
🚀 詳細な設定とコードはこちら
具体的なWAFのルール設定や、より詳細なログ解析データは元のブログで公開しています。