Symfony服务器启动报PostgreSQL错误 访问不存在路由也抛出数据库连接异常

根本触发逻辑 #

你使用symfony new myproject --full命令创建的是全量依赖的Symfony项目，默认预装了Doctrine ORM组件，默认配置的数据库类型为PostgreSQL，监听端口5432。你本地未启动对应PostgreSQL服务，因此所有需要触发数据库连接的操作都会抛出连接异常。

为什么404路由返回数据库错误而非路由不存在提示 #

Symfony开发环境下，触发异常（包括404 NotFoundHttpException）时会自动加载调试异常页，该页面依赖Profiler调试组件记录请求上下文信息。默认配置下Profiler会将调试数据持久化存储到数据库中，因此渲染404异常页时会触发数据库连接操作，此时数据库连接失败抛出的异常优先级高于原有404异常，最终页面展示数据库连接错误。

为什么默认首页可以正常加载 #

Symfony默认首页为无状态静态欢迎页，全程不涉及数据库操作，也不会触发Profiler数据持久化逻辑，因此不会触发数据库连接异常。

临时验证方案 #

修改开发环境Profiler配置，将存储介质改为文件系统，无需依赖数据库：

1. 编辑config/packages/dev/web_profiler.yaml文件，添加/修改profiler存储配置：

framework:
    profiler:
        storage: 'profiler.storage.filesystem'

2. 重启symfony serve服务，再次访问不存在的路由即可看到正常的404提示页面。

永久解决方案 #

修正数据库配置，保证Doctrine可以正常连接：

1. 打开项目根目录下的.env或.env.local文件，修改DATABASE_URL参数为你本地可用的数据库连接地址，例如使用SQLite可改为：
   DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
2. 执行命令php bin/console doctrine:database:create创建对应数据库，重启服务即可恢复所有功能正常。

• 项目根目录下.env文件中DATABASE_URL的配置内容
• config/packages/doctrine.yaml的完整配置
• config/packages/dev/web_profiler.yaml的完整配置
• 本地运行的数据库服务类型、端口及运行状态

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