要显示yii2 mongodb真实错误，必须同时开启php错误输出、启用yii调试模式、确保mongodb扩展正确加载并配置；还需在配置中禁用retrywrites、用ping命令测试连接、cli命令加--verbose参数。
Yii2 MongoDB 操作报错默认不显示真实错误，尤其在生产环境或配置疏漏时，常表现为白屏、500 Internal Server Error 或静默失败（比如 findOne() 返回 null 但没报错）。要看到真实报错，必须同时满足三个条件：开启 PHP 错误输出、启用 Yii 调试模式、确保 MongoDB 扩展和驱动层错误不被拦截。
强制显示 PHP 层原始错误信息
很多 MongoDB 报错（如 SyntaxError: missing ] after element list、Authentication failed）实际来自 PHP 扩展或连接初始化阶段，会被 PHP 的错误抑制机制吞掉。必须手动放开：
- 打开
web/index.php，在第一行附近插入两行（位置不能错）：error_reporting(E_ALL);<br>ini_set('display_errors', '1'); - 确认
YII_DEBUG已设为true：defined('YII_DEBUG') or define('YII_DEBUG', true);—— 若是false，ErrorHandler 会捕获所有异常并转成白屏 - 如果用 CLI 运行（如
php yii migrate），同样要在yii入口脚本顶部加这两行，否则只看到PHP Warning被忽略
验证 mongodb 扩展是否真加载成功
报错显示不出来，有时根本不是代码问题，而是扩展压根没跑起来。常见假象是 DSN 写对了、配置看着没问题，但 php -m | grep mongodb 输出为空，或输出的是 mongo（旧版已废弃）而非 mongodb（新版）：
- 运行
php -m | grep mongodb，必须输出mongodb；若无输出，说明扩展未启用，需检查php.ini是否加载了extension=mongodb.so（Linux/macOS）或php_mongodb.dll（Windows） - 若输出
mongo，代表装的是已废弃的旧扩展，与 Yii2-mongodb 不兼容，必须卸载并重装新版：sudo pecl install mongodb - 扩展装完后，重启 Web 服务器（Apache/Nginx）或 PHP-FPM，否则配置不生效
让 MongoDB 驱动错误穿透到前端
即使扩展加载了，Yii2-mongodb 默认会把底层驱动异常包装成 yii\mongodb\Exception，而某些场景下（如连接参数错误、认证失败）仍可能被上层逻辑静默吞掉。关键干预点有两处：
- 在配置中显式关闭自动重连和静默降级：
'options' => [<br> 'connectTimeoutMS' => 3000,<br> 'socketTimeoutMS' => 5000,<br> 'retryWrites' => false,<br>],
避免因超时重试掩盖初始错误 - 临时在控制器里加一行测试连接：
Yii::$app->mongodb->getDatabase()->command(['ping' => 1]);，如果这里抛出异常，说明 DSN 或权限配置错了，错误会直接冒出来 - 查日志不如看实时报错：确保
runtime/logs/app.log有写入权限，但优先依赖display_errors—— 日志里有时只记“Connection failed”，而页面上能看清是authSource=admin not found还是Failed to parse MongoDB URI
Console 命令报错特别难定位？加 --verbose
执行 php yii some-command 时 MongoDB 报错常被吞掉，尤其涉及集合操作、聚合查询或批量插入。此时 --verbose 不是可选项，是刚需：
- 它会让 Yii 把日志级别提到
trace，并强制打印未捕获异常的完整堆栈，包括 vendor 里的调用链 - 例如运行
php yii mymongo/import --verbose，你能看到：Executing command: insertMany on collection 'users'→ 底层抛出的MongoDB\Driver\Exception\AuthenticationException→ 具体哪行 DSN 参数缺失 - 注意：如果命令本身用了
$this->confirm()，务必同时加--interactive，否则确认逻辑跳过，错误根本不会触发
最容易被忽略的是：即使 php -m 显示 mongodb、DSN 语法看着正确、模型也按规范写了 primaryKey()，只要 authSource 指错了库（比如用户建在 admin 却配成 ?authSource=myapp），错误依然静默——这时候只有 --verbose + display_errors=1 双开，才能把 Authentication failed 真实暴露出来。
