Symfony配置PostgreSQL自定义Schema执行迁移连接超时问题

PostgreSQL 自定义Schema场景下Doctrine正确配置方式 #

PostgreSQL的对象层级为「实例 -> 数据库 -> Schema -> 表/函数等对象」，dbname字段仅对应数据库层级的名称，绝对不能拼接Schema名，否则驱动会将database_name.my_schema整体作为数据库名寻址，必然报数据库不存在。
正确配置步骤如下：

• 修改/config/packages/doctrine.yaml，仅在dbname字段填写真实数据库名，补充Schema相关配置：

doctrine:
  dbal:
    dbname: 'my_db'
    user: 'user'
    password: 'xxxxxxxx'
    host: 'xxxxxxxx'
    port: 1520
    driver: 'pdo_pgsql'
    server_version: '13'
    # 指定默认操作的Schema
    schema: 'my_schema'
    options:
      # 连接建立后自动设置搜索路径，优先查找自定义Schema
      1002: "SET search_path TO my_schema, public"
  orm:
    entity_managers:
      default:
        mappings:
          App:
            is_bundle: false
            dir: '%kernel.project_dir%/src/Entity'
            prefix: 'App\Entity'
            alias: App
        default_table_options:
          schema: 'my_schema'

• 登录PostgreSQL给业务账号授权并配置默认Schema：

-- 授予Schema操作权限
GRANT ALL ON SCHEMA my_schema TO "user";
GRANT ALL ON ALL TABLES IN SCHEMA my_schema TO "user";
ALTER DEFAULT PRIVILEGES IN SCHEMA my_schema GRANT ALL ON TABLES TO "user";
-- 配置账号默认搜索路径
ALTER USER "user" SET search_path TO my_schema, public;

仅填数据库名时迁移命令超时失败的原因 #

感知到的“填写纯数据库名连接正常”是环境差异导致的错觉：

• 日常开发调试、容器启动后手动执行脚本时，运行环境的网络是打通的，可以正常访问远程PostgreSQL服务，因此连接测试、简单查询能正常返回。
• Dockerfile中的RUN命令是在镜像构建阶段执行的，该阶段的网络环境和容器运行时完全隔离：要么是Docker构建默认网络策略限制了外部1520端口访问，要么是远程PostgreSQL的IP白名单没有加入构建机的出口IP，最终导致连接超时，和Schema配置无直接关系。
• 就算构建阶段网络打通，未指定默认Schema时Doctrine会默认操作public Schema，迁移生成的表、迁移版本记录都会落到public下，不符合自定义Schema的使用预期。

修复建议 #

• 不要在镜像构建阶段执行数据库迁移命令：镜像构建是生成静态可部署制品的过程，不应该依赖外部数据库服务。应该把迁移命令挪到容器启动入口脚本中，等容器启动完成、网络连通性校验通过后再执行迁移。
• 如果因特殊流程必须在构建阶段执行迁移，执行docker build时添加--network=host参数让构建过程共享宿主机网络，同时联系数据库管理员将构建机出口IP加入白名单，放开1520端口访问权限，该方案存在环境耦合风险，非必要不使用。

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