执行make installcheck时出现pg_regress: initdb failed错误求助

1. 检查PostgreSQL环境变量配置 #

确保PostgreSQL的bin目录已加入系统PATH，同时验证PGDATA变量设置正确：

echo $PATH | grep postgres
echo $PGDATA

如果PATH中未包含PG的bin路径，手动添加（示例路径为/usr/local/pgsql/bin，请替换为你的实际安装路径）：

export PATH=/usr/local/pgsql/bin:$PATH
export PGDATA=/usr/local/pgsql/data

可将上述两行添加到~/.bashrc中实现永久生效。

2. 手动测试initdb可用性 #

直接执行initdb命令排查基础问题，指定临时目录并跳过locale检查（适配WSL环境）：

initdb -D /tmp/test_pg_data --no-locale -U postgres

根据报错信息针对性修复：

• 权限错误：确认/tmp目录权限正常，或更换为其他有读写权限的临时目录
• locale错误：坚持使用--no-locale参数规避WSL的locale配置问题
• 命令找不到：回到第一步修正PATH配置

3. 调整installcheck执行参数 #

在AGE源码目录执行installcheck时，明确指定PG配置路径、临时实例目录并跳过locale检查：

make installcheck PG_CONFIG=/usr/local/pgsql/bin/pg_config USE_PGXS=1 CHECK_REGRESS_OPTS="--temp-instance=/tmp/age_test_instance --no-locale"

注意替换PG_CONFIG为你的实际pg_config路径，--temp-instance指定的目录需确保当前用户有读写权限。

4. 修复目录权限问题 #

确保当前用户对PostgreSQL安装目录和AGE源码目录拥有完整读写权限：

sudo chown -R $USER:$USER /usr/local/pgsql
sudo chown -R $USER:$USER /path/to/age/source

将/path/to/age/source替换为你的AGE源码实际路径。

5. 规避PostgreSQL服务冲突 #

虽然installcheck会启动临时实例，但系统中运行的PG服务可能引发端口或资源冲突，先停止服务再测试：

pg_ctl stop -D /usr/local/pgsql/data

6. 查看详细错误日志 #

若问题仍未解决，开启VERBOSE模式获取详细输出，或查看AGE源码目录下test/regress/log中的日志文件：

make installcheck VERBOSE=1

日志会记录initdb失败的具体原因，可据此精准修复。

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