docker-compose启动时CSV填充PostgreSQL表报文件找不到如何解决

开发者阿泽

2026-8-29

问题根因

该错误和迁移容器的卷配置没有直接关系，核心原因是对PostgreSQL的COPY命令执行逻辑存在认知偏差：
不带反斜杠的COPY ... FROM '文件路径'属于PostgreSQL服务端命令，实际执行文件读取操作的是运行PostgreSQL进程的database容器，而非运行golang-migrate的迁移容器。
你当前仅将customers.csv挂载到了迁移容器的/migrations路径下，PostgreSQL容器的内部文件系统中完全不存在该CSV文件，因此会抛出文件不存在的报错。

可行解决方案

你可以根据自己的场景选以下任意一种方案实现：

方案1：调整服务端COPY路径+挂载CSV到PostgreSQL容器
1. 修改docker-compose配置，给PostgreSQL服务追加migrations目录的只读挂载，避免文件散落在数据库容器的敏感路径：
```
database:
  image: postgres:15 # 替换为你实际使用的PostgreSQL版本
  environment:
    POSTGRES_USER: postgres
    POSTGRES_PASSWORD: password
    POSTGRES_DB: database
  volumes:
    - ./migrations:/tmp/migrations:ro
```
2. 将迁移SQL文件中的COPY语句替换为PostgreSQL容器内的绝对路径：
```
COPY customers FROM '/tmp/migrations/customers.csv' CSV HEADER;
```
注意PostgreSQL进程默认以postgres用户运行，需要提前确认本地CSV文件的权限允许其他用户读取，避免触发权限拒绝错误。
方案2：改用客户端侧导入逻辑（推荐）
不要在迁移SQL中直接使用服务端COPY语句，将CSV数据初始化拆为独立步骤：等建表迁移执行完成后，在能访问到CSV文件的客户端侧（可以是改造后的迁移镜像，也可以是临时启动的postgres客户端容器），使用psql的\copy元命令执行导入。\copy是客户端命令，文件读取操作由发起连接的客户端完成，不需要给数据库容器挂载额外文件：
```
psql postgres://postgres:password@database:5432/database?sslmode=disable -c "\copy customers FROM '/migrations/customers.csv' CSV HEADER"
```
注意migrate/migrate官方镜像默认没有内置psql客户端，使用该方案可以基于官方镜像额外安装postgresql-client依赖，也可以直接用官方postgres镜像作为初始化客户端，不需要额外构建镜像。该方案完全解耦了迁移逻辑和数据库运行环境，后续调整数据库部署位置时不需要修改导入逻辑。
方案3：直接将初始化数据写入迁移SQL（适合小数据量场景）
如果CSV内的初始化数据量不大，可以直接将数据转换为INSERT语句写在迁移SQL文件中，完全不依赖外部文件，迁移执行的一致性最高，也不会出现路径、权限相关的问题。

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