Spring Boot+MongoDB：如何兼顾Id字段JSON返回与findById查询？

我来帮你搞定这个头疼的问题！你遇到的核心矛盾是：实体类用大写Id时JSON能返回字段，但Spring Data的查询方法找不到属性；用小写id时查询正常，但JSON又不输出这个字段。下面是具体的解决方案：

1. 调整实体类的注解配置 #

问题根源在于Spring Data MongoDB默认会把实体类的小写id字段映射到MongoDB的_id主键，而Jackson序列化会直接用你定义的字段名。我们可以通过注解让两者兼容：

import com.fasterxml.jackson.annotation.JsonProperty;
import org.springframework.data.annotation.Id;

public class Resource {
    @Id
    @JsonProperty("Id")  // 指定Jackson序列化时输出的字段名为"Id"
    private String id;    // 保持小写id，符合Spring Data的命名约定

    // 其他字段
    // 别忘了添加getter和setter方法
}

这样做的好处：

• Spring Data MongoDB能识别小写的id作为主键，不会再抛出InvalidPersistentPropertyPath异常
• Jackson序列化时会把这个字段输出为Id，满足你JSON返回的需求

2. 简化Repository接口 #

你不需要自定义findById方法，因为MongoRepository已经继承了CrudRepository的findById方法，直接用就行：

import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.data.rest.core.annotation.RepositoryRestResource;

@RepositoryRestResource(collectionResourceRel = "resources", path = "resources")
public interface ResourceRepository extends MongoRepository<Resource, String> {
    // 这里不需要额外定义findById，父接口已经提供了Optional<Resource> findById(String id)
}

3. 验证效果 #

现在你可以测试两个核心需求：

• 发送GET请求http://localhost:8080/resources/，返回的JSON数据里会包含Id字段
• 发送GET请求http://localhost:8080/resources/{your-id}，或者http://localhost:8080/resources/search/findById?id={your-id}，都能正常查询到数据，不会再抛出异常

关于你自定义控制器的补充 #

如果你还是需要用自定义控制器，记得把Criteria.where("Id")改成Criteria.where("id")（因为实体类里的字段是小写id，Spring Data会映射到MongoDB的_id），或者直接用ResourceRepository的findById方法更简洁：

import org.springframework.web.bind.annotation.*;
import java.util.Optional;

@Controller
@RequestMapping("/resource")
public class ResourceController {
    private final ResourceRepository resourceRepository;

    // 用构造注入代替@Autowired，更符合Spring规范
    public ResourceController(ResourceRepository resourceRepository) {
        this.resourceRepository = resourceRepository;
    }

    @GetMapping("/findById/{resourceId}/")
    @ResponseBody
    public Resource findByResourceId(@PathVariable("resourceId") String resourceId) {
        return resourceRepository.findById(resourceId)
                .orElse(null); // 根据业务需求处理空值，比如返回404
    }
}

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