Symfony连接Oracle必须手动配置Doctrine的oci8驱动，禁用serverVersion自动探测，DATABASE_URL需用oci8://协议及Easy Connect格式（如oci8://user:pass@//host:1521/ORCLPDB1），并确保PHP已启用oci8扩展。
Symfony 默认不内置 Oracle 支持，必须手动配置 Doctrine 的 Oracle 驱动（oci8）并调整连接参数；直接复用 MySQL 的 DATABASE_URL 格式会失败，报错如 Driver "oci8" not found 或 ORA-12154: TNS could not resolve the connect identifier。
安装 oci8 扩展和 Doctrine Oracle 驱动
Oracle 连接依赖 PHP 的 oci8 扩展，不是纯 PHP 实现，不能靠 composer require 补齐。
- Linux（Ubuntu/Debian）需先装 Oracle Instant Client：
sudo apt install libaio1，再下载并安装oracle-instantclient-basic和oracle-instantclient-devel - PHP 编译时要带
--with-oci8=instantclient,/usr/lib/oracle/instantclient_21_12；或使用预编译包（如 Ubuntu 的php-oci8包） - 确认扩展已启用：
php -m | grep oci8，没输出说明没装好 - Doctrine 不提供
oracle://协议支持，必须改用oci8://—— 这是关键，DATABASE_URL里写oracle://会直接报错
正确配置 DATABASE_URL（oci8 协议 + TNS 名或 Easy Connect）
DATABASE_URL 必须用 oci8:// 开头，且不支持 query 参数（如 ?serverVersion=19c 会被忽略）；Oracle 连接串格式和 MySQL 完全不同。
- 推荐用 Easy Connect 语法：
oci8://user:pass@//host:1521/ORCLPDB1（注意双斜杠//和 service_name） - 若用 TNS 名，需确保
$ORACLE_HOME/network/admin/tnsnames.ora存在且可读，URL 写成oci8://user:pass@MYDB - 密码含
@、/等字符必须 URL 编码，例如pa@s/word→pa%40s%2Fword - 别在
.env里写localhost：Oracle 客户端可能解析失败，显式写 IP（如192.168.1.100）更稳
doctrine.yaml 中必须禁用 serverVersion 自动探测
Doctrine 对 Oracle 的 serverVersion 不做自动识别，硬填会触发异常；doctrine.yaml 里必须删掉或注释掉该字段。
- 错误写法：
serverVersion: '19c'→ 启动时报Unknown database server version - 正确写法：在
doctrine.dbal.connections.default下**完全不配置**serverVersion，Doctrine 会 fallback 到通用 Oracle 平台 - 如果项目同时连 MySQL 和 Oracle，多连接配置下每个 connection 要单独定义，不能共用
serverVersion - 验证是否生效：运行
php bin/console doctrine:database:create，成功说明驱动和连接串都通了
常见报错与绕过方式
Oracle 权限模型比 MySQL 严格得多，doctrine:database:create 基本不可用——它试图执行 CREATE DATABASE，而 Oracle 中这需要 SYSDBA 权限，普通用户根本做不到。
-
ORA-01031: insufficient privileges：放弃用 Doctrine 命令建库，改用 SQL*Plus 或sqlplus / as sysdba手动建表空间和用户 -
ORA-12545: Connect failed because target host or object does not exist：检查tnsping ORCLPDB1是否通，或换 Easy Connect 格式重试 -
PDOException: SQLSTATE[HY000]: General error: 1476 ORA-01476：通常是空值参与除法运算，不是连接问题，查实体字段是否设了nullable=false但 DB 允许 NULL - CI/CD 环境中，Docker 镜像需提前装好 oci8，官方
php:apache镜像默认不含，得自己docker-php-ext-install oci8
Oracle 连接最耗时间的环节从来不是配置 URL，而是让 PHP 真正加载并调通 oci8 扩展；一旦扩展就位，后续参数基本是拼凑字符串的事。别在 serverVersion 上纠结，也别指望 Doctrine 替你管理 Oracle 的 schema 生命周期。
