Symfony 6.0 默认不支持 SQL Server，因 doctrine/dbal v3.0 移除了 sqlsrv 驱动，须改用 pdo_odbc + Microsoft ODBC Driver 方案；降级到 dbal ^2.13 不推荐。
Symfony 6.0 默认不支持 SQL Server，doctrine/dbal 从 v3.0 起移除了对 sqlsrv 和 pdo_sqlsrv 的原生驱动支持，必须手动降级或换用 pdo_odbc + Microsoft ODBC Driver 方案——否则连 doctrine:database:create 都会直接报错。
Doctrine 3.x 不再内置 sqlsrv 支持
Symfony 6.0 默认装的是 doctrine/dbal:^3.0，而 DBAL v3 移除了所有非 PDO 标准驱动（包括 sqlsrv），只保留 pdo_mysql、pdo_pgsql、pdo_sqlite 和 pdo_odbc。你如果在 DATABASE_URL 里写 sqlsrv://... 或 pdo_sqlsrv://...，Doctrine 会直接抛出 Unknown driver "sqlsrv" 异常。
可行路径只有两条：
- 降级到
doctrine/dbal:^2.13（兼容 Symfony 6.0，但已 EOL，不推荐长期用） - 改用
pdo_odbc驱动 + Microsoft ODBC Driver for SQL Server（官方推荐路径）
用 pdo_odbc 连 SQL Server（推荐）
这是目前最稳定、被 Microsoft 官方文档明确支持的方式，核心是把连接转给系统 ODBC 层处理，Doctrine 只管调 PDO::odbc。
操作分三步：
- Windows：安装 ODBC Driver 18 for SQL Server，确保
odbcinst -j（Linux/macOS）或 ODBC 数据源管理器（Windows）里能查到ODBC Driver 18 for SQL Server - Linux（如 Ubuntu 24.04）：
apt install -y unixodbc odbcinst→ 下载并dpkg -i msodbcsql18.deb→ 验证odbcinst -j -d输出含该驱动 -
.env中改写DATABASE_URL：pdo_odbc:///?odbc=DRIVER={ODBC Driver 18 for SQL Server};SERVER=localhost;PORT=1433;DATABASE=mydb;UID=sa;PWD=mypassword
注意：odbc=... 后面那段是标准 ODBC 连接字符串，不是 URL 编码格式；特殊字符（如 @、/）不用 URL 编码，但得在 ODBC 字符串里用双花括号或反斜杠转义（例如 PWD=pass@word → PWD=pass@@word）。
常见报错和对应检查点
连不上时，别急着改 Symfony 配置，先确认底层是否通：
-
SQLSTATE[HYT00] [0] Login timeout expired：TCP/IP 没开、防火墙拦了 1433、SQL Server 实例名写错（不是localhost而是localhost\SQLEXPRESS）、SQL Server Browser 服务没启（对命名实例必需） -
SQLSTATE[IMSSP] or SQLSTATE[08001]：ODBC 驱动未注册或版本不匹配（比如装了 Driver 17 却在连接串里写 Driver 18） -
Connection refused：SQL Server 未启用 TCP/IP 协议（用SQL Server Configuration Manager开） -
Access denied：用户没权限，或认证方式不对（SQL Server 2019+ 默认禁用sql_login，需执行ALTER USER sa WITH PASSWORD = 'xxx'; ALTER USER sa WITH CHECK_POLICY = OFF;）
Entity 映射和迁移的兼容性坑
即使连上了，SQL Server 对 Doctrine 的约束支持仍弱于 MySQL/PostgreSQL：
-
datetime字段在 Entity 中必须声明为type="datetime"，不能用datetime_immutable（会报类型不识别） -
doctrine:migrations:diff生成的 SQL 可能含ALTER TABLE ... DROP COLUMN，但 SQL Server 不允许直接删主键列或有默认值的列——得手动拆成多步 - 索引名长度限制 128 字符，Doctrine 自动生成的复合索引名容易超长，需在
@ORMIndex中显式设name="idx_xxx"
真正卡住的地方往往不在 Symfony 配置层，而在 ODBC 驱动注册是否成功、SQL Server 实例是否监听 TCP、以及 Windows 身份验证与 SQL 身份验证混用导致的协议协商失败——这些底层链路断了，上层再怎么调 DATABASE_URL 都没用。
