Symfony数据库连接成败取决于DATABASE_URL是否合法完整可连通，doctrine.yaml仅启用组件和映射，不参与实际连接；必须写对协议头、IP地址、serverVersion、URL编码及charset参数。
DATABASE_URL 必须写对，其他配置只是配角
Symfony 数据库连接成败几乎全取决于 DATABASE_URL 是否合法、完整、可连通。它不是“可选项”，而是唯一生效的连接入口——doctrine.yaml 里写的 host、user 等字段在 Symfony ≥ 4 中会被完全忽略，只读取 %env(DATABASE_URL)%。
- 协议头不能省：
mysql://、pgsql://、sqlite://必须显式写出 - 本地开发用
127.0.0.1，别写localhost：后者可能触发 Unix socket 连接，报SQLSTATE[HY000] [2002] No such file or directory -
serverVersion参数必须显式声明，例如?serverVersion=8.0；Doctrine 靠它决定生成什么语法，缺了会 fallback 到低版本，导致JSON字段、窗口函数等失效 - 密码含
@、/、:等要 URL 编码，比如pass@word→pass%40word - 推荐加上
&charset=utf8mb4，避免 emoji 或四字节中文存不进库
MySQL 8.0 连不上？先查认证插件，不是配错 URL
常见报错 Access denied for user 'xxx'@'xxx' 或直接连接失败，大概率不是 DATABASE_URL 写错了，而是 MySQL 8.0 默认禁用 mysql_native_password 插件，而老项目或某些客户端（包括部分 Doctrine 版本）仍依赖它。
- 进 MySQL 执行：
ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY 'my%40pass'; - 确认用户有对应权限：至少
GRANT CREATE, SELECT, INSERT, UPDATE, DELETE ON myapp.* TO 'app_user'@'%'; - Docker 环境下，检查 MySQL 容器是否暴露了
3306端口，且bind-address没锁死在127.0.0.1 - 远程数据库还要确认云服务商防火墙放行了该端口
多数据库连接要分清 connection 和 service
要加第二个库（比如日志库、报表库），不能只改 .env，得在 config/packages/doctrine.yaml 里明确定义 connection 块，并确保服务容器能解析出对应 service。
- 在
dbal.connections下新增一个连接，例如report_db，填全url（推荐用%env(resolve:REPORT_DATABASE_URL)%，和主库解耦） - 默认只注入
doctrine.dbal.default_connection；要用第二个库，得显式声明依赖：doctrine.dbal.report_db_connection - 控制器里这么用：
public function index(\Doctrine\DBAL\Connection $reportConnection)，前提是类型提示匹配 service 名 - 别在
services.yaml里手动 factoryDriverManager::getConnection()—— Doctrine Bundle 已自动注册所有 connection service，重复定义反而冲突
建库和建表，别碰 schema:update --force
这个命令在本地“看着快”，但跳过迁移历史、不校验变更顺序、不兼容 MySQL 8.0.23+ 的 ALGORITHM=INPLACE 限制，线上绝对禁用。
- 初始化新库用：
php bin/console doctrine:database:create（注意：它用的是DATABASE_URL里的用户，不是 root；权限不够就先手动建库） - 建表或改结构，必须走迁移：
php bin/console make:migration→ 检查生成的 PHP 文件 →php bin/console doctrine:migrations:migrate - CI/CD 流程中，
doctrine:migrations:migrate是唯一安全的上线执行命令
真正容易被忽略的，是 serverVersion 和认证插件这两处——它们不报语法错误，但会让字段类型、JSON 函数、甚至连接本身静默失败。每次换 MySQL 大版本或切 Docker 镜像，都得重验这两项。
