直接运行 composer require doctrine/dbal 很可能失败，因 dbal v4 要求 php 8.1+ 且不支持 mysql 5.7、postgresql 10 等旧版本；应先检查是否已存在（composer show | grep doctrine），再按 php 版本选 ^3.7（php 8.0+）或 ^2.13（php 7.4）安装。
直接运行 composer require doctrine/dbal 很可能失败，尤其在 Laravel 10+、Symfony 6+ 或 PHP 版本较旧的项目里。装不上不是因为你命令错了，而是版本不兼容——DBAL v4 要求 PHP 8.1+ 且已放弃对 MySQL 5.7、PostgreSQL 10 等旧数据库的支持。
先查项目里有没有 DBAL
很多现代框架（如 Laravel、Symfony）默认已带 DBAL，你根本不需要再 require。盲目加包反而触发版本冲突。
- 运行
composer show | grep doctrine，看是否已有doctrine/dbal - 如果有，且版本是
^3.7或^2.13，直接用；想升级就跑composer update doctrine/dbal - 如果只有
doctrine/orm没有doctrine/dbal，那 ORM 会自动拉取它所依赖的 DBAL 版本，也不用单独装
真要全新安装，必须指定兼容版本
别信“最新版最稳定”——DBAL 的主版本跃迁破坏性很强。v2 和 v3 的连接配置结构不同，v4 则彻底砍掉对老环境的支持。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 8.0+ 项目：用
composer require doctrine/dbal:^3.7 - PHP 7.4 项目（比如旧 Laravel 8）：只能用
composer require doctrine/dbal:^2.13 - 绝对不要写
composer require doctrine/dbal:*或不带版本号——Composer 默认选 v4，大概率报错
装完连不上 MySQL，报 “Unknown database type json”
这不是没装成功，是 DBAL 版本太低或没识别到字段类型。MySQL 5.7+ 的 JSON 字段在 DBAL v2.13 和 v3.4+ 才被原生支持。
- 先确认版本：
composer show doctrine/dbal，低于2.13就必须升级 - v2.13+ 通常能自动识别，但如果用了自定义驱动或平台类，可能需要手动注册：
$platform->registerDoctrineTypeMapping('json', 'json') - PostgreSQL 用户注意：
jsonb在 v3 才原生支持，v2 需自己写类型类
最容易被忽略的一点：DBAL 不是“装完就能查数据”的工具。它只负责连接和 Schema 抽象，不处理实体映射、查询构建器自动补全、或 ORM 行为——那些得靠 doctrine/orm 或手写 SQL。装对版本只是第一步，后续所有 Schema 操作（比如 createTable、alterColumn）都依赖平台类型注册是否完整，而这个完整性，往往藏在你没注意到的 types 配置或驱动初始化逻辑里。
