📝
【FastAPI開発者必見】"email-validator version >= 2.0 required" エラーの解決方法
FastAPIでアプリを起動しようとしたとき、以下のようなエラーに遭遇したことはありませんか？
ImportError: email-validator version >= 2.0 required, run pip install -U email-validator
この記事では、このエラーの原因と、最短での解決方法を解説します。
❓ エラー内容
FastAPIを uvicorn で起動すると、次のようなエラーが表示されて起動に失敗します。
ImportError: email-validator version >= 2.0 required, run pip install -U email-validator
このメッセージの通り、FastAPIの内部で使われている pydantic が email-validator のバージョン2.0以上を必要としているのが原因です。
💡 解決方法（1行でOK）
以下のコマンドを実行して、email-validator をアップグレードするだけです。
pip install -U email-validator
✅ 確認方法
pip show email-validator
バージョンが 2.0.0 以上であれば問題ありません。
🧠 なぜ必要なのか？
FastAPIでは、EmailStr 型をバリデーションに使うために、email-validator という外部ライブラリを利用しています。
from pydantic import BaseModel, EmailStr
class User(BaseModel):
email: EmailStr
このようなコードがアプリ内に含まれている場合、email-validator が古いと起動時にエラーになります。
🔧 依存パッケージの管理も忘れずに
もし requirements.txt や pyproject.toml を使っているなら、以下のようにしてバージョンを固定しておきましょう。
requirements.txt の場合：
email-validator>=2.0.0
Poetry の場合：
email-validator = "^2.0.0"
📌 まとめ
| 内容 | 対処法 |
|---|---|
| エラー内容 | email-validator version >= 2.0 required |
| 原因 | Pydantic が最新の email-validator を要求 |
| 解決法 | pip install -U email-validator |
FastAPIは便利な分、依存関係でつまずくこともありますが、エラーメッセージを素直に読んで対処するのが一番の近道ですね 💡
🙌 おわりに
この記事が「FastAPI初心者の壁」を越える手助けになれば嬉しいです！
いいね・フォロー・コメント大歓迎です！
Discussion