如何解决新Laravel项目中的内部服务器错误与Symfony异常

一、解决PostgreSQL连接拒绝（SQLSTATE[08006] [7] Connection refused） #

核心排查点（Sail容器环境） #

• 修正.env数据库主机配置：Sail容器内的PostgreSQL服务主机名是postgres而非localhost，确保.env配置如下：

  DB_CONNECTION=pgsql
  DB_HOST=postgres
  DB_PORT=5432
  DB_DATABASE=你的数据库名
  DB_USERNAME=你的数据库用户名
  DB_PASSWORD=你的数据库密码
  

• 验证PostgreSQL容器状态：执行sail ps查看postgres容器是否处于Up状态，若未启动，执行sail restart postgres重启容器。
• 排查端口冲突：若本地已安装PostgreSQL占用5432端口，修改.env中的DB_PORT为其他值（如5433），同时在docker-compose.yml中同步修改端口映射：

  postgres:
    ports:
      - '5433:5432'
  

• 测试容器内数据库连接：进入PHP容器执行命令验证连接：

  sail exec php bash
  psql -h postgres -U 你的数据库用户名 -d 你的数据库名
  

  若能成功进入数据库，则容器内连接正常，问题出在本地配置或网络。

本地PostgreSQL（非Sail容器）额外配置 #

如果使用本地安装的PostgreSQL：

1. 修改/etc/postgresql/{版本号}/main/postgresql.conf：

   listen_addresses = '*'
   

2. 修改/etc/postgresql/{版本号}/main/pg_hba.conf，添加外部连接规则：

   host all all 0.0.0.0/0 md5
   

3. 重启PostgreSQL服务：sudo systemctl restart postgresql

二、解决Symfony权限拒绝（Failed to open stream: Permission denied） #

该问题源于Ubuntu环境下Laravel存储/缓存目录权限与Sail容器用户不一致，执行以下步骤修复：

• 修复目录权限：

  sudo chown -R $USER:www-data storage bootstrap/cache
  sudo chmod -R 775 storage bootstrap/cache
  

• 清理缓存并创建存储链接：

  sail artisan cache:clear
  sail artisan config:clear
  sail artisan storage:link
  

• 避免权限根源问题：创建新项目时使用Sail官方命令，确保容器与本地目录权限一致：

  curl -s "https://laravel.build/你的项目名" | bash
  cd 你的项目名
  ./vendor/bin/sail up
  

• 排查AppArmor限制：Ubuntu默认的AppArmor可能阻止Docker访问本地目录，临时关闭测试：

  sudo systemctl stop apparmor
  

  若问题解决，需配置AppArmor规则允许Docker访问项目目录。

三、综合排查流程 #

1. 优先解决权限问题，避免权限异常干扰数据库连接排查。
2. 验证Sail容器服务状态，确保postgres容器正常运行。
3. 严格按照Sail环境配置.env中的数据库主机，禁止使用localhost。
4. 测试容器内数据库连接，定位问题是在容器内部还是外部网络。

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