Symfony2 + Doctrine2 + MongoDB 開發 LBS 應用：地理位置查詢深度解析與方案對比

專案背景

移動互聯網時代，LBS (Location-Based Services) 應用爆發式增長。核心技術挑戰：海量用戶實時位置的高效儲存、範圍查詢、距離排序。本文基於 Symfony2 + Doctrine2 ODM + MongoDB 組合，深度解析地理位置查詢方案選型與實作。

LBS 應用核心需求

• 「附近的人/地」：以經緯度為圓心，半徑 R 範圍內查詢目標。
• 按距離由近到遠排序。
• 顯示精確距離 (米/公里)。
• 支援高併發寫入 (用戶位置上報) 與讀取 (周邊查詢)。

四大技術方案橫向對比

方案一：MySQL 純 SQL 球面距離計算

SELECT id,
  (6371 * ACOS(
    COS(RADIANS(37)) * COS(RADIANS(lat)) * COS(RADIANS(lng) - RADIANS(-122)) +
    SIN(RADIANS(37)) * SIN(RADIANS(lat))
  )) AS distance
FROM places
HAVING distance < 25
ORDER BY distance
LIMIT 0, 100;

優點：無遷移成本、SQL 標準、關聯查詢靈活。
缺點：全表掃描計算距離，CPU 密集，無法使用索引，百萬級資料查詢秒級以上，不可用於生產。

方案二：MySQL + GeoHash 索引

• 將經緯度編碼為 GeoHash 字串 (Base32)，相鄰區域共享前綴。
• 建立 INDEX(geohash)，查詢時計算目標 GeoHash 及相鄰 8 格前綴，WHERE geohash LIKE 'wx4g0%'。
• 優點：利用 B-Tree 索引加速、實現簡單。
• 缺點：邊界問題需掃描 9 格、精度受 GeoHash 長度限制、距離排序仍需應用層計算、寫入需額外計算編碼。

方案三：MySQL Spatial Extensions (GIS)

• 使用 POINT(lat, lng) 地理類型，建立 SPATIAL INDEX (R-Tree)。
• 查詢：MBRContains(GeomFromText('Polygon(...))', location) 或 ST_Distance_Sphere (MySQL 5.7+)。
• 優點：原生空間索引、標準 OGC 函數、支援多邊形、緩衝區分析。
• 缺點：MyISAM 才支援 SPATIAL INDEX (5.7 前)、InnoDB 5.7+ 才支援、距離排序效能一般、功能較 MongoDB 受限。

方案四：MongoDB 原生地理空間索引 (推薦)

• 2dsphere 索引 (支援球面幾何、GeoJSON)：

  
  db.places.createIndex({ location: "2dsphere" })
  

• 查詢操作符：
  • $near / $nearSphere：按距離排序返回最近文檔。
  • $geoWithin + $centerSphere / $box / $polygon：範圍查詢不排序。
  • $geoIntersects：幾何相交判斷。
• 範例：查詢附近 5 公里內咖啡廳，按距離排序：

  
  db.places.find({
    location: {
      $nearSphere: {
        $geometry: { type: "Point", coordinates: [121.5, 25.0] }, // [lng, lat]
        $maxDistance: 5000  // 米
      }
    },
    type: "cafe"
  }).limit(20)
  

• 輸出包含距離 (需 aggregation pipeline)：

  
  db.places.aggregate([
    {
      $geoNear: {
        near: { type: "Point", coordinates: [121.5, 25.0] },
        distanceField: "dist.calculated",
        maxDistance: 5000,
        spherical: true,
        query: { type: "cafe" }
      }
    },
    { $limit: 20 }
  ])
  

MongoDB 優勢總結

Symfony2 + Doctrine2 ODM 實作範例

1. 實體映射：

   
   /**
    * @ODM\Document(collection="places")
    * @ODM\Index(keys={"location"="2dsphere"})
    */
   class Place {
       /** @ODM\Id */
       protected $id;
       
       /** @ODM\Field(type="string") */
       protected $name;
       
       /** @ODM\Field(type="string") */
       protected $type; // cafe, restaurant, atm...
       
       /**
        * @ODM\EmbedOne(targetDocument="GeoPoint")
        * @ODM\Index(type="2dsphere")
        */
       protected $location;
       
       // Getter/Setter...
   }
   
   /** @ODM\EmbeddedDocument */
   class GeoPoint {
       /** @ODM\Field(type="string") */
       protected $type = "Point";
       
       /** @ODM\Field(type="collection") */
       protected $coordinates = []; // [lng, lat]
   }
   

2. Repository 查詢封裝：

   
   class PlaceRepository extends DocumentRepository {
       public function findNearby(GeoPoint $point, $maxDistance = 5000, $limit = 20, $type = null) {
           $qb = $this->createQueryBuilder()
               ->field('location')->nearSphere($point->getCoordinates())
               ->maxDistance($maxDistance)
               ->limit($limit);
           if ($type) $qb->field('type')->equals($type);
           return $qb->getQuery()->execute();
       }
       
       public function findWithinPolygon(array $coordinates, $limit = 50) {
           // $coordinates = [[lng,lat], [lng,lat], ...] 封閉多邊形
           return $this->createQueryBuilder()
               ->field('location')->geoWithin(['$geometry' => ['type' => 'Polygon', 'coordinates' => [$coordinates]]])
               ->limit($limit)
               ->getQuery()->execute();
       }
   }
   

3. 控制器暴露 API：

   
   class PlaceController extends Controller {
       public function nearbyAction(Request $request) {
           $lng = $request->query->get('lng');
           $lat = $request->query->get('lat');
           $radius = $request->query->get('radius', 5000);
           
           $point = new GeoPoint();
           $point->setCoordinates([$lng, $lat]);
           
           $places = $this->get('doctrine_mongodb')
               ->getRepository('AcmeDemoBundle:Place')
               ->findNearby($point, $radius);
           
           $serializer = $this->get('jms_serializer');
           return new Response($serializer->serialize($places, 'json'));
       }
   }
   

效能優化關鍵點

1. 索引策略：複合索引 {type: 1, location: "2dsphere"} 加速類型過濾 + 空間查詢。
2. 讀寫分離：MongoDB Replica Set，寫入 Primary，查詢 Secondary (可接受 eventual consistency)。
3. Sharding：以 location 為 Shard Key (配合 hashed sharding) 水平擴展。
4. 連線池：Doctrine MongoDB ODM 配置 connections.default.options.connectTimeoutMS=3000、serverSelectionTimeoutMS=5000。
5. 投影優化：查詢僅選取必要欄位 ->select('name', 'type', 'location') 減少網路傳輸。

常見坑點與解決

結語

MongoDB 原生 2dsphere 索引配合 $nearSphere/$geoNear 管線，提供開箱即用、高效能、標準化的地理空間查詢能力，是 LBS 應用的最佳資料庫選擇。Symfony2 + Doctrine2 ODM 提供優雅的物件映射與查詢建構器，讓開發者專注業務邏輯而非底層 SQL/查詢語法。生產環境務必關注索引策略、Sharding 規劃、讀寫分離與監控告警，確保百萬級用戶實時位置服務穩定運行。