symfony数据库连接核心是将完整合法的database_url写入.env文件，如mysql://user:pass%40word@127.0.0.1:3306/db?serverversion=8.0&charset=utf8mb4；doctrine.yaml仅启用组件和映射，不负责实际连接。
Symfony 连接数据库的核心就一条：把连接参数写进 .env 文件的 DATABASE_URL 里，其他配置文件（比如 doctrine.yaml）只管启用组件和定义映射规则，不负责连库本身。
DATABASE_URL 必须写对格式
这是最容易出错的地方。URL 必须是完整、合法的字符串，不能缺字段，也不能用错符号：
- 协议头不能少：
mysql://（PostgreSQL 是pgsql://，SQLite 是sqlite://） - 本地开发推荐用
127.0.0.1，别写localhost——后者可能触发 Unix socket 连接，报No such file or directory -
serverVersion参数必须显式声明，例如?serverVersion=8.0或?serverVersion=5.7；Doctrine 靠它决定 SQL 语法兼容性 - 密码含特殊字符（如
@、/、:）要 URL 编码，例如pass@word→pass%40word - 推荐加上字符集参数：
&charset=utf8mb4，避免中文乱码或 emoji 存储失败
正确示例：
DATABASE_URL="mysql://app_user:my%40pass@127.0.0.1:3306/myapp?serverVersion=8.0&charset=utf8mb4"
权限和网络问题常被当成配置错误
命令如 php bin/console doctrine:database:create 报 Access denied，大概率不是 URL 写错了，而是 MySQL 用户没给够权限：
- 该用户至少要有
CREATE权限：执行GRANT CREATE ON *.* TO 'app_user'@'%'; - 远程数据库要确认防火墙放行 3306 端口，MySQL 服务允许外部连接（
bind-address不能是127.0.0.1） - Docker 环境下，MySQL 8.0 默认禁用旧认证插件，老项目连不上时，运行：
ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY 'my%40pass';
建表别直接用 schema:update --force
这个命令在本地调试看着方便，但有严重隐患：
- 它不读迁移历史，只比对当前实体和现有表结构，容易跳过中间版本，导致线上数据不一致
- MySQL 8.0.23+ 对
ALTER TABLE ... ALGORITHM=INPLACE更严格，某些字段变更会被拒绝 - 正确流程是：
php bin/console make:migration→ 生成迁移文件php bin/console doctrine:migrations:migrate→ 安全执行
需要连多个数据库？得配多连接
默认只有一个 default 连接。要加第二个（比如报表库、日志库），需两步操作：
- 在
config/packages/doctrine.yaml的dbal.connections下新增一个连接块，比如report_db，填好 host、user、dbname 等 - 在
services.yaml中定义对应的服务，例如：doctrine.dbal.report_connection:
class: Doctrine\DBAL\Connection
factory: ['Doctrine\DBAL\DriverManager', 'getConnection']
arguments: [{ url: 'mysql://...'}] - 控制器中按需注入：
public function index(Connection $reportConnection)
