Symfony2集成MongoDB需正确配置Doctrine ODM、处理BSON类型、适配时间字段并避免MySQL查询习惯；必须使用mongodb扩展（非mongo），URI需规范编码与连接池设置，CRUD操作须用ObjectId和UTCDateTime，查询依赖QueryBuilder。
Symfony2 项目中集成 MongoDB 并非简单加个扩展就能跑通，关键在 Doctrine ODM（Object Document Mapper）的正确配置、BSON 类型处理、查询构造逻辑和时间字段适配。用错 ObjectId 或 UTCDateTime，查不到数据；忽略连接池配置，线上容易连接耗尽；混用 MySQL 查询习惯写 MongoDB，结果为空也不报错。
确认 MongoDB 扩展与 Doctrine ODM 已就绪
Doctrine ODM 不依赖已废弃的 mongo 扩展，必须使用 mongodb 扩展（PHP 7.1+ 官方驱动）：
- 运行
php -m | grep mongodb，输出含 mongodb（不是 mongo）才表示扩展加载成功 - 访问
phpinfo()页面，查找 “mongodb” 模块区块，确认 Version ≥ 1.10 且 Directives 中mongodb.default_host等项正常 - 在
composer.json中添加："doctrine/mongodb-odm": "^2.4",<br>"doctrine/doctrine-mongodb-odm-bundle": "^4.5"
- 执行
composer install后，运行php bin/console doctrine:mongodb:fixtures:load验证 ODM 命令是否识别
连接配置与 URI 写法避坑
Symfony2 使用 doctrine_mongodb.yaml 配置连接，URI 格式直接影响认证、超时和连接复用：
- 本地开发无认证：用
mongodb://127.0.0.1:27017，避免localhost（可能触发 IPv6 解析失败） - 生产带账号密码：密码含
@、/、:时必须 URL 编码，例如rawurlencode('p@ss/w0rd') - 务必显式限制连接池：
mongodb://user:pass@host:27017/mydb?maxPoolSize=30&minPoolSize=5&connectTimeoutMS=2000 - 若报
Connection refused，先检查mongod是否运行、bindIp是否允许本机连接（netstat -tuln | grep 27017）
增删改查（CRUD）实操要点
ODM 查询不走 DQL，而是基于 Repository + Criteria + QueryBuilder，且类型强敏感：
- 插入文档时，
_id字段必须用new \MongoDB\BSON\ObjectId()构造，否则后续按 ObjectId 查询会失败 - 时间字段不能传
DateTime对象或 Unix 时间戳整数，必须转为UTCDateTime：new \MongoDB\BSON\UTCDateTime(strtotime('2025-06-01') * 1000) - 查询嵌套字段如
profile.address.city，需确保插入时该路径存在；若字段为null或未设置，find(['profile.address.city' => 'Beijing'])将不匹配 - 分页推荐用
QueryBuilder：$qb->limit(20)->skip(40)->sort(['createdAt' => -1])
时间范围查询与 LBS 场景适配
前端传入时间字符串（如 2025-06-01），需统一转为 UTCDateTime 才能被 MongoDB 正确比较：
- 起止时间处理示例：
$start = new UTCDateTime(strtotime($startDate . ' 00:00:00') * 1000);<br>$end = new UTCDateTime(strtotime($endDate . ' 23:59:59') * 1000);
- 查询语句：
$qb->field('createdAt')->gte($start)->lte($end) - LBS 地理查询（如附近用户）需提前建 2dsphere 索引：
db.users.createIndex({ location: "2dsphere" })，对应 PHP 中用$qb->field('location')->near('$geometry' => [...])
