Mongo-Java Spring MVC 4连接：插入操作仅生效一次问题求助

嘿，我来帮你排查下这个只能插入一次的问题，结合Spring MVC 4和MongoDB的常见坑，大概有这几个方向：

1. 实体类ID生成逻辑错误 #

这是最常见的原因之一。如果你的实体类用@Id标记主键，但没配置自动生成策略，或者手动设置了固定ID，第二次插入时就会因为ID重复导致失败（MongoDB默认会把重复ID的插入操作转为更新，或者直接抛出DuplicateKeyException）。

排查方式： #

检查你的实体类代码，比如这种情况就会出问题：

public class User {
    @Id
    private String id; // 如果手动赋值且重复，第二次插入会冲突
    private String name;
    // getter/setter
}

要是每次插入都复用同一个User实例，只修改name但没重置id，第二次插入时MongoDB会认为是更新这条数据，而非新增。

解决方案： #

• 让MongoDB自动生成ID：确保@Id字段在插入前为null，MongoTemplate会自动生成ObjectId作为主键；
• 若要自定义ID，每次插入前生成新的唯一值（比如UUID）：

user.setId(UUID.randomUUID().toString());
mongoTemplate.insert(user);

2. MongoDB连接池配置不足 #

如果Spring配置里MongoDB连接池的参数设置不合理，比如最大连接数太小，第一次请求占用连接后没正确释放，第二次请求就会因为拿不到连接而阻塞或失败。

排查方式： #

检查你的Spring配置文件（比如applicationContext.xml）中的连接池配置：

<mongo:mongo-client host="localhost" port="27017">
    <mongo:client-options connections-per-host="1" /> <!-- 连接数设为1就会导致只能一次操作 -->
</mongo:mongo-client>

解决方案： #

调整连接池参数，增大connections-per-host（默认是100，若被误改需修正），同时设置合理的超时时间：

<mongo:mongo-client host="localhost" port="27017">
    <mongo:client-options 
        connections-per-host="100"
        max-wait-time="10000"
        connect-timeout="5000"/>
</mongo:mongo-client>

3. Spring事务配置错误 #

如果你在Spring MVC 4中配置了MongoDB事务，但你的MongoDB是单节点（单节点不支持事务，事务需要副本集），或者事务配置有误，可能导致第一次事务未提交，第二次操作被阻塞。

排查方式： #

检查DAO层或Service层是否加了@Transactional注解，而你的MongoDB环境不支持事务。单节点MongoDB开启事务会导致操作异常或不生效。

解决方案： #

• 若为单节点MongoDB，移除不必要的@Transactional注解；
• 若需要事务，搭建MongoDB副本集后再正确配置Spring的Mongo事务管理器。

4. 代码复用了同一个实体对象实例 #

如果Controller或Service层在多次请求中复用同一个实体对象，没有每次插入前重新创建新实例，可能导致对象状态被Spring缓存影响，或者ID未重置，进而导致第二次插入失败。

排查方式： #

比如这种错误的写法：

@Controller
public class UserController {
    private User user = new User(); // 全局复用实例，错误！

    @PostMapping("/addUser")
    public String addUser(String name) {
        user.setName(name);
        userDao.insert(user);
        return "success";
    }
}

第一次插入后user的ID已经被赋值，第二次插入时ID重复，就会变成更新而非新增。

解决方案： #

每次插入前创建新的实体实例：

@PostMapping("/addUser")
public String addUser(String name) {
    User user = new User(); // 每次请求新建实例
    user.setName(name);
    userDao.insert(user);
    return "success";
}

5. 未正确捕获MongoDB写入异常 #

可能第二次插入时已经抛出异常，但你的代码没捕获，导致看起来像是没执行。比如插入时违反了集合的唯一索引约束（除ID外的其他字段），导致插入失败但未被发现。

排查方式： #

在插入代码中添加异常捕获，打印日志：

try {
    mongoTemplate.insert(user);
} catch (Exception e) {
    e.printStackTrace(); // 查看具体异常信息，定位问题
}

如果是DuplicateKeyException，说明存在唯一索引冲突。

解决方案： #

检查集合的索引配置，移除不必要的唯一索引，或者确保插入的字段值符合唯一约束。

内容的提问来源于stack exchange，提问作者Austin Y