MongoDB 啟動失敗：dbpath 路徑含空格導致初始化錯誤

問題現象

在 Windows 環境下執行 mongod.exe --dbpath=...... 啟動 MongoDB 時，若路徑中包含空格（例如 C:\Program Files\MongoDB\data），控制台會報「初始化失敗」錯誤，資料庫無法正常啟動。

根本原因

命令列參數解析時，空格會被視為參數分隔符，導致 --dbpath 後的路徑被截斷，MongoDB 找不到完整的資料目錄。

解決方法

將 dbpath 路徑用雙引號括起來，確保完整路徑被正確識別：

mongod.exe --dbpath="C:\Program Files\MongoDB\data"

最佳實踐建議

• 盡量避免在資料目錄路徑中使用空格或特殊字元。
• 生產環境建議使用設定檔（mongod.cfg）啟動服務，避免命令列參數轉義問題。
• 若需作為 Windows 服務運行，請透過 mongod.exe --config "C:\path\mongod.cfg" --install 註冊服務。

總結

MongoDB 啟動參數中的路徑若含空格，必須加上雙引號，否則會因路徑截斷導致初始化失敗。養成良好的路徑命名習慣可從根源避免此類問題。