使用TablePlus连接Laravel Sail Docker的PostgreSQL报错角色sail不存在

问题根因排查与解决方案 #

最常见诱因：误连本地PostgreSQL服务 #

你本地大概率已安装运行了独立的PostgreSQL服务，用TablePlus/Postico连接时默认用了5432端口，实际请求打到了本地PostgreSQL而非Docker内的Sail PostgreSQL服务，本地库自然不存在sail角色。

分步解决 #

1. 确认Docker PostgreSQL对外映射端口
   执行以下命令查看端口映射：

docker compose ps pgsql

在输出的PORTS列可看到类似0.0.0.0:5433->5432/tcp的结果，箭头左侧的端口就是你本地连接需要用的端口（示例中为5433），.env里的5432是Docker内部网络的通信端口，不能直接用于宿主机工具连接。
2. 核对数据库连接配置
在TablePlus/Postico中填入以下配置：

• 主机地址：127.0.0.1
• 端口：上一步查到的对外映射端口
• 用户名：sail
• 密码：password
• 数据库名：laravel_docker

3. 可选：确认容器内角色存在
   如果配置正确仍连接失败，可进入容器验证sail角色是否存在：

# 进入Laravel容器
sail shell
# 连接PostgreSQL
psql -h pgsql -U sail laravel_docker
# 查看所有角色
\du

如果输出列表中有sail角色，说明问题仍出在宿主机连接配置上，可检查本地防火墙、端口占用情况。
4. 极端情况：重置容器数据
如果确认是容器初始化时环境变量和现有.env不匹配，可执行以下命令重置容器（注意：会删除所有现有数据库数据）：

sail down -v
sail up -d
# 重新执行迁移和填充
sail artisan migrate --seed

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