項目場景

在使用 Spring Data MongoDB 進行開發時，定義了一個名為 CompetitionSignUpLog 的實體類，并創建了對應的 Repository 接口。需要明確該實體類在 MongoDB 中實際對應的集合名稱是 CompetitionSignUpLog 還是 competitionSignUpLog。

問題描述

不確定 MongoDB 中自動生成的集合名稱是基于實體類名稱的哪種大小寫形式：

• CompetitionSignUpLog（首字母大寫）
• competitionSignUpLog（首字母小寫）

這會影響直接通過 MongoDB shell 或其他客戶端工具查詢數據時的集合名稱使用。

原因分析

Spring Data MongoDB 默認的集合名稱生成規則如下：

1. 常規情況：將類名的第一個字母轉換為小寫
   • 例如：CompetitionSignUpLog → competitionSignUpLog
2. 特殊情況：如果類名的前兩個字母都是大寫，則保持原樣
   • 例如：COMPETITIONSignUpLog → COMPETITIONSignUpLog

對于 CompetitionSignUpLog 類：

• 首字母 C 是大寫，第二個字母 o 是小寫
• 因此會應用常規規則，轉換為首字母小寫形式 competitionSignUpLog

解決方案

方案1：查看實際集合名稱

直接連接到 MongoDB 數據庫，查看自動生成的集合名稱：

use your_database_name;
show collections;

方案2：顯式指定集合名稱

在實體類上添加 @Document 注解明確指定集合名稱：

import org.springframework.data.mongodb.core.mapping.Document;@Document(collection = "competitionSignUpLog") // 明確指定集合名稱
public class CompetitionSignUpLog {// ... 類定義
}

最佳實踐建議

推薦使用 @Document 顯式指定集合名稱，避免依賴默認規則

保持命名一致性：

Java 類名：CompetitionSignUpLog（首字母大寫）

集合名稱：competitionSignUpLog（首字母小寫）

在 Repository 中無需關心實際集合名稱，Spring Data 會自動處理映射關系