Windowsで toio.py で `cannot import name '_RawAdvData'` | TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
Windows上のPython 3.12環境において、toio.pyが依存するbleakライブラリの内部モジュール '_RawAdvData' が参照できず、ImportErrorが発生する。これはbleakのアップデートに伴う内部実装の変更が、toio.pyの既存コードと互換性を失ったことが原因である。
// Approach
既存のbleakを削除した後、互換性が確認されている特定のバージョン（0.22.3）を明示的に指定してインストールする。また、依存関係の競合を避けるため、python -m venv を用いてプロジェクト専用のクリーンな仮想環境を構築する手法を採用している。
// Result
toio.py 1.1.0 と bleak 0.22.3 を組み合わせた環境を構築することで、エラーが解消され、正常に動作することを確認した。
Senior Engineer Insight
> 典型的な依存関係の不整合（Dependency Hell）の事例である。ライブラリがアンダースコアで始まるプライベートな属性（_RawAdvData）に依存している設計は、アップグレード時に極めて脆弱である。実戦においては、単にバージョンを固定して回避するだけでなく、なぜ破壊的変更が起きたのかを分析し、ライブラリ側の修正を待つか、抽象化レイヤーを挟む検討が必要だ。また、開発環境の再現性を担保するため、Poetryやpipenv等を用いた厳格な依存関係管理を標準化すべきである。