使用POSTGRES_PASSWORD_FILE时Postgres密码长度限制问题咨询

我用Docker Compose部署基于Next.js 14 + TypeScript的Web应用，搭配Postgres数据库和Prisma ORM。最近碰到一个奇怪的问题：当db_password.txt里的密码长度超过21字符时，就算更新了数据库URL、删除旧镜像和卷后重启容器，应用还是会抛出认证错误：

Authentication failed against database server at `localhost`, the provided database credentials for `postgres` are not valid.

密码长度在21字符及以下时一切正常。想问有没有人遇到过同样的问题？Postgres、Docker Compose或者Prisma的文档里有没有提到过这个限制？

附相关配置文件：

docker-compose.yml #

services:
  db:
    image: postgres:latest
    restart: always
    environment:
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
    secrets:
      - db_password
    ports:
      - 5432:5432
    volumes:
      - pgdata:/var/lib/postgresql/data
      - ./prisma/init.sql:/docker-entrypoint-initdb.d/init.sql

volumes:
  pgdata:

secrets:
  db_password:
    file: prisma/db_password.txt

schema.prisma #

datasource db {
    provider = "postgresql"
    url      = env("DATABASE_URL")
}

generator client {
    provider = "prisma-client-js"
}

可能的原因及解决办法 #

• 密码特殊字符未转义：如果密码包含@、/、%这类特殊字符，数据库URL里必须对密码部分做URL编码（比如@转%40，/转%2F）。可以用encodeURIComponent(密码)生成转义后的字符串，替换到DATABASE_URL中。
• Docker Secrets带多余换行：如果db_password.txt末尾有换行符，Docker会把换行也算进密码里，导致实际密码不符。可以用tr -d '\n' < prisma/db_password.txt > prisma/db_password_fixed.txt去掉换行后替换原文件。
• Postgres卷残留旧数据：有时候删除卷不彻底，Postgres容器还是用了旧的密码哈希。执行docker-compose down -v彻底清理卷，再重新启动容器。
• 手动密码设置逻辑问题：如果init.sql里有硬编码的密码设置语句，可能未同步更新长密码。可以进入Postgres容器执行ALTER USER postgres WITH PASSWORD '你的长密码';手动更新后再测试。

验证步骤 #

1. 用纯字母数字的22字符密码测试，排除特殊字符干扰。如果能正常连接，说明是特殊字符转义的问题。
2. 进入Postgres容器手动验证：

   docker exec -it <你的db容器名> psql -U postgres
   

   输入长密码如果能登录，说明Postgres本身配置没问题，问题出在应用端的URL或Docker Secrets传递环节。

内容的提问来源于stack exchange，提问作者Vanja Stojanović