FastAPI使用testing.postgresql时报错找不到initdb命令如何解决？

错误原因 #

RuntimeError: command not found: initdb 报错的根本原因是 testing.postgresql 依赖本地安装的PostgreSQL官方二进制组件，initdb 是PostgreSQL自带的数据库初始化工具，你的本地环境未安装PostgreSQL，或者PostgreSQL的可执行文件目录未加入系统环境变量PATH，导致库无法调用该工具。

解决方案 #

第一步：安装本地PostgreSQL #

根据你的操作系统选择对应安装方式：

• Windows系统：下载PostgreSQL官方安装包执行安装，安装时勾选「Add PostgreSQL to PATH」选项；如果未勾选，手动将PostgreSQL安装目录下的bin文件夹（默认路径为C:\Program Files\PostgreSQL\你的版本号\bin）添加到系统环境变量PATH中，添加完成后重启终端/IDE使配置生效。
• macOS系统：执行brew install postgresql即可完成安装，Homebrew会自动配置环境变量。
• Linux（Debian/Ubuntu系）：执行sudo apt install postgresql postgresql-contrib完成安装。

安装完成后在终端执行initdb --version，如果能正常输出版本号即说明配置生效。

第二步：修正现有代码逻辑 #

你当前的代码存在逻辑错误：模块加载时执行with testing.postgresql.Postgresql() as postgresql代码块，代码块结束后临时PostgreSQL实例会被自动销毁，后续初始化的database连接实际指向已经不存在的测试库，完全无法使用。

建议将测试数据库的初始化逻辑放到测试框架的生命周期管理中，以pytest为例，使用fixture管理测试数据库的启停：

# conftest.py 测试配置文件
import pytest
import testing.postgresql
from sqlalchemy import create_engine
from databases import Database
from your_project.models import Base # 导入你的ORM基类

@pytest.fixture(scope="session")
async def test_database():
    # 启动临时PostgreSQL实例
    with testing.postgresql.Postgresql() as postgresql:
        # 初始化数据库连接
        engine = create_engine(postgresql.url())
        # 创建测试所需表结构
        Base.metadata.create_all(engine)
        database = Database(str(engine.url))
        await database.connect()
        yield database
        # 测试结束后断开连接
        await database.disconnect()

正式环境的数据库连接逻辑保持不变，仅测试时调用上述fixture获取测试数据库连接即可。

替代方案（无需安装PostgreSQL） #

如果你的业务代码没有使用PostgreSQL专属语法，也可以直接使用SQLite内存数据库作为测试数据库，无需额外安装任何组件：

# 测试场景下的数据库连接
engine = create_engine("sqlite:///./test.db?check_same_thread=False")
database = Database("sqlite:///./test.db?check_same_thread=False")

内容的提问来源于stack exchange，提问作者HuLu ViCa