使用testing.postgres时出现“Command not found: initdb”错误求助

问题根源 #

testing.postgresql需要调用系统中PostgreSQL服务端的二进制工具（比如initdb），你在Python环境安装的postgres包只是Python客户端库，并非完整的PostgreSQL服务端；或者服务端已安装，但它的bin目录没被加入系统环境变量PATH，导致工具无法被找到。

方法1：安装完整PostgreSQL服务端并配置PATH #

• 安装服务端：
  • Windows：从PostgreSQL官网下载安装包，安装时勾选「Add PostgreSQL to PATH」选项
  • macOS：通过Homebrew执行 brew install postgresql
  • Linux：用系统包管理器，比如Ubuntu执行 sudo apt install postgresql
• 配置PATH：确保PostgreSQL的bin目录（例如Windows下的C:\Program Files\PostgreSQL\16\bin、macOS下的/usr/local/opt/postgresql/bin）被添加到系统PATH环境变量中
• 重启终端或IDE，让环境变量生效后重新运行测试

方法2：手动指定initdb路径 #

如果不想修改系统PATH，可以在初始化Postgresql对象时，直接指定initdb的完整路径：

from unittest import TestCase
import testing.postgresql
import psycopg2
import postgres

class TestCOUDB(TestCase):
    def test_COUDB(self):
        # 替换为你系统中initdb的实际路径
        self.postgresql = testing.postgresql.Postgresql(
            port=7654,
            initdb="/path/to/your/postgresql/bin/initdb"
        )
        print(self.postgresql.url())

示例路径参考：

• Windows："C:/Program Files/PostgreSQL/16/bin/initdb.exe"
• macOS/Linux："/usr/local/opt/postgresql/bin/initdb"

方法3：用Docker替代testing.postgresql（可选） #

若不想在本地安装PostgreSQL，可使用Docker启动临时测试数据库，更灵活且无需配置环境：

from unittest import TestCase
import psycopg2
import docker
import time

class TestCOUDB(TestCase):
    def setUp(self):
        client = docker.from_env()
        # 启动PostgreSQL容器
        self.container = client.containers.run(
            "postgres:16",
            environment={"POSTGRES_PASSWORD": "testpass"},
            ports={"5432/tcp": 7654},
            detach=True
        )
        # 等待容器初始化完成
        time.sleep(5)

    def test_COUDB(self):
        conn = psycopg2.connect(
            dbname="postgres",
            user="postgres",
            password="testpass",
            host="localhost",
            port=7654
        )
        # 在此执行你的数据库操作测试逻辑
        conn.close()

    def tearDown(self):
        # 测试结束后停止并删除容器
        self.container.stop()
        self.container.remove()

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