Docker部署PostgreSQL后VS Code Database Client连接异常求助

1. 强制容器字符集为UTF-8 #

在你的docker-compose.yml中添加字符集初始化参数，确保PostgreSQL服务端使用UTF-8编码：

services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_DB: your_db_name
      POSTGRES_USER: your_user
      POSTGRES_PASSWORD: your_pass
      # 明确指定编码
      POSTGRES_INITDB_ARGS: --encoding=UTF8 --lc-collate=C --lc-ctype=C
    ports:
      - "5432:5432"

重启容器后，进入容器执行命令验证编码：

docker exec -it <容器ID/名称> psql -U your_user -c "SHOW server_encoding;"

确认输出为UTF8。

2. 修正VS Code Database Client连接配置 #

• 打开连接设置面板，找到高级选项，强制设置字符编码为UTF-8
• 若用户名包含特殊字符，用双引号包裹后输入（比如"my-user"）
• 确认连接地址填写localhost（而非容器内部IP），端口与docker-compose映射的端口一致

3. 本地验证连接排除插件问题 #

用本地psql客户端直接连接测试：

psql -h localhost -p 5432 -U your_user your_db_name

如果本地连接正常无乱码，说明问题出在VS Code插件本身：

• 禁用并重新启用Database Client插件
• 卸载插件后安装最新版本，或清除插件缓存（VS Code设置中搜索Database Client: Cache Path，删除对应目录文件）

4. 检查容器内用户配置 #

进入容器执行命令查看用户列表，确认用户名无乱码：

docker exec -it <容器ID/名称> psql -U postgres -c "\du"

若用户名显示异常，删除现有用户重新创建：

DROP USER your_user;
CREATE USER your_user WITH PASSWORD 'your_pass';
GRANT ALL PRIVILEGES ON DATABASE your_db_name TO your_user;

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