Spring Boot微服务中PostgreSQL数据库初始化失败问题求助

看起来你遇到的是PostgreSQL容器初始化脚本不执行或者执行失败的问题，我之前在搭建微服务数据库环境时也踩过几乎一模一样的坑，咱们一步步来排查和解决：

首先排查最容易忽略的「数据卷缓存」问题 #

PostgreSQL容器有个特性：第一次启动初始化完成后，会在数据卷里标记初始化完成，之后再启动容器时，会跳过/docker-entrypoint-initdb.d/目录下的所有脚本。如果你之前启动过这个容器，哪怕后来修改了脚本，容器也不会再执行它了。

解决方法很简单，先彻底清理旧的数据卷：

docker-compose down -v

之后再重新启动容器，PostgreSQL会重新执行初始化脚本。

检查脚本的权限和格式问题 #

你虽然执行了chmod +x init.sh，但还有两个潜在问题：

1. 换行符格式：如果是在Windows环境下编写的脚本，默认是CRLF换行，但Linux容器里的bash只认LF换行，这会导致脚本执行失败。可以用Notepad++或者VS Code把脚本转换为「LF换行格式」。
2. 挂载时权限丢失：有些情况下，挂载到容器的文件权限会被重置，你可以在Docker Compose里临时加一个命令，先给脚本加权限再启动（不过Postgres官方镜像的entrypoint其实会处理可执行脚本，这步算是兜底）：

   services:
     postgres:
       # 其他配置不变
       command: ["bash", "-c", "chmod +x /docker-entrypoint-initdb.d/init.sh && docker-entrypoint.sh postgres"]
   

查看容器日志定位具体错误 #

这是最关键的一步！不管是什么问题，容器日志都会给出线索。执行以下命令查看日志：

docker logs postgres

你可以重点看这些内容：

• 有没有显示「Executing /docker-entrypoint-initdb.d/init.sh」的日志，确认脚本被执行了
• 如果脚本执行失败，日志里会明确标出SQL错误或者bash错误，比如变量未找到、SQL语法错误等

简化脚本逐步排查 #

你的脚本一次性创建了多个数据库和用户，建议先简化脚本，只保留最基础的创建语句，比如：

#!/bin/bash -x
set -e

echo "Starting init..."

psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
CREATE DATABASE inventory_db;
\connect inventory_db
CREATE USER inventory_user WITH PASSWORD 'inventory_password';
EOSQL

echo "Init done!"

用这个简化版脚本测试，如果能成功创建，再逐步加回其他语句，这样能快速定位是哪一行出了问题。

关于Liquibase的补充 #

等数据库和用户创建成功后，你可以在Liquibase配置里指定对应数据库的连接信息（比如inventory_db的用户名inventory_user、密码inventory_password），这样Liquibase就能直接连接到指定数据库创建表结构了。

备注：内容来源于stack exchange，提问作者Murat Yıldız