Symfony CLI本地开发时Mac系统如何开放5432端口？

5432是PostgreSQL数据库的默认服务端口，你遇到的报错本质是Symfony无法连接到本地运行的PostgreSQL服务，按以下步骤排查解决即可：

步骤1：检查5432端口占用情况 #

先确认端口是否有进程在监听，执行对应系统的命令：

• Windows（CMD/PowerShell）：netstat -ano | findstr :5432
• macOS/Linux（终端）：lsof -i :5432
  如果命令无输出，说明PostgreSQL服务未启动，直接走步骤2；如果有输出，说明服务已启动，走步骤3排查防火墙/配置问题。

步骤2：启动PostgreSQL服务 #

根据你安装PostgreSQL的方式和操作系统选择对应操作：

• Windows安装版：按Win+R输入services.msc打开服务管理器，找到PostgreSQL对应的服务项，右键选择「启动」，可设置为自动启动避免后续重复操作。
• macOS（Homebrew安装）：执行brew services start postgresql
• Linux（Debian/Ubuntu系）：执行sudo systemctl start postgresql && sudo systemctl enable postgresql
• Docker环境：检查docker-compose.yml配置中是否添加了5432端口映射，ports段需包含- "5432:5432"，修改后重启容器即可。

步骤3：放行防火墙5432端口 #

如果服务已启动仍无法连接，大概率是本地防火墙拦截了端口请求：

• Windows：打开Windows Defender防火墙高级设置，分别新建入站、出站规则，选择「端口」类型，指定TCP端口5432，选择允许连接，所有网络环境生效即可。
• Linux（UFW防火墙）：执行sudo ufw allow 5432/tcp && sudo ufw reload
• macOS：进入系统设置→网络→防火墙→选项，将PostgreSQL添加到允许传入连接的列表中。

步骤4：校验Symfony数据库配置 #

打开项目根目录下的.env.local（优先级高于.env）文件，确认数据库连接串配置正确，参考格式：

DATABASE_URL="postgresql://你的数据库用户名:你的数据库密码@127.0.0.1:5432/你的数据库名?serverVersion=15&charset=utf8"

注意核对用户名、密码、数据库名、PostgreSQL版本是否和本地安装的版本一致，避免配置错误导致的连接失败。

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