概要

fastapi dev main.pyが実行できるようになるまでに自分が行った手順をまとめます。
Mac 上で venv を使い、PostgreSQL（Postgres.app）と連携する環境でのトラブルシューティングです。

状況

fastapi dev main.pyを実行したところ、以下のエラーが表示された：

ModuleNotFoundError: No module named 'psycopg2'

まず psycopg2 をインストール：

pip install psycopg2

以下のエラーが出た：

Error: pg_config executable not found.
pg_config is required to build psycopg2 from source.

psycopg2のインストールにはpg_configが必要。
pg_configは PostgreSQL のビルド設定情報を格納しているファイルで、通常は PostgreSQL インストール時に作られるはず。

まず pg_config が見つかるか確認：

which pg_config
# → pg_config not found

Postgres.app に存在する pg_config を探す：

find /Applications/Postgres.app -name pg_config
# → /Applications/Postgres.app/Contents/Versions/18/bin/pg_config

PATH を通すため、~/.zshrc に追記：

export PATH="/Applications/Postgres.app/Contents/Versions/18/bin:$PATH"

シェルを再読み込み：

source ~/.zshrc

再度 psycopg2 をインストール：

pip install psycopg2

→ 成功

しかし、fastapi dev main.py を実行すると依然として同じエラー：

ModuleNotFoundError: No module named 'psycopg2'

実行時に使われる Python が、仮想環境ではなく Anaconda 環境の Python になっていた：

which python
# → /opt/anaconda3/bin/python

仮想環境を有効化して Python を切り替え：

source venv/bin/activate

その後、再度 FastAPI を起動：

fastapi dev main.py
# または
uvicorn main:app --reload