Thymeleaf表单无法处理org.bson.Document类型的问题求助

这个问题我之前也碰到过，核心原因是Spring MVC没法自动把表单提交的字符串转换成org.bson.Document类型——毕竟Thymeleaf渲染隐藏域时只是把Document调用toString()输出成了普通字符串，提交后自然没法反序列化回去。下面给你几个可行的解决方案：

Spring MVC允许我们注册自定义的类型转换器，用来在字符串和org.bson.Document之间互相转换，这样整个项目里的类似场景都能自动处理。

首先创建字符串转Document的转换器：

import org.bson.Document;
import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

@Component
public class StringToDocumentConverter implements Converter<String, Document> {
    @Override
    public Document convert(String source) {
        if (source == null || source.trim().isEmpty()) {
            return null;
        }
        // 把表单提交的JSON字符串解析成Document
        return Document.parse(source);
    }
}

再创建Document转字符串的转换器，方便Thymeleaf渲染成标准JSON：

import org.bson.Document;
import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

@Component
public class DocumentToStringConverter implements Converter<Document, String> {
    @Override
    public String convert(Document source) {
        if (source == null) {
            return "";
        }
        // 将Document序列化为JSON字符串，确保隐藏域存储的是标准格式
        return source.toJson();
    }
}

Thymeleaf的隐藏域写法不需要修改，Spring会自动调用转换器处理：

<input id="resetPassword" th:field="${user.resetPassword}" type="hidden"/>
<input id="consents" th:field="${user.consents}" type="hidden"/>

这样表单提交时，Spring会自动把JSON字符串转回Document对象，400错误就消失了。

如果不想修改全局转换器，也可以用DTO（数据传输对象）来隔离实体类和表单交互，只在当前场景处理转换逻辑。

先创建一个UserFormDTO，把Document字段换成String类型存储JSON：

@Data
public class UserFormDTO {
    private String id;
    private String email;
    private String name;
    private String surname;
    private String phone;
    private String password;
    private String country;
    private SecurityLevel securityLevel;
    // 用字符串存储Document的JSON格式
    private String resetPassword;
    private String consents;
}

然后在控制器里完成实体和DTO的转换：

// 展示编辑页面：把User转成DTO
@GetMapping("/edit/{id}")
public String showEditForm(@PathVariable ObjectId id, Model model) {
    User user = userRepository.findById(id).orElseThrow();
    UserFormDTO dto = new UserFormDTO();
    // 复制允许修改的字段
    BeanUtils.copyProperties(user, dto);
    // 把Document转成JSON字符串赋值给DTO
    dto.setResetPassword(user.getResetPassword() != null ? user.getResetPassword().toJson() : "");
    dto.setConsents(user.getConsents() != null ? user.getConsents().toJson() : "");
    model.addAttribute("user", dto);
    return "user-edit";
}

// 提交表单：把DTO转回User
@PostMapping("/edit")
public String submitEditForm(@ModelAttribute UserFormDTO dto) {
    User user = userRepository.findById(new ObjectId(dto.getId())).orElseThrow();
    BeanUtils.copyProperties(dto, user);
    // 把JSON字符串转回Document
    if (!dto.getResetPassword().isEmpty()) {
        user.setResetPassword(Document.parse(dto.getResetPassword()));
    }
    if (!dto.getConsents().isEmpty()) {
        user.setConsents(Document.parse(dto.getConsents()));
    }
    userRepository.save(user);
    return "redirect:/users";
}

Thymeleaf隐藏域写法不变，因为现在绑定的是DTO里的String类型，不会有转换问题。

既然这两个字段不允许修改，其实完全没必要把它们传到前端再传回来——既避免了转换问题，还能防止用户篡改隐藏域内容（比如恶意修改JSON）。

实现思路：

1. 表单里只传递user.id，移除resetPassword和consents的隐藏域。
2. 提交表单时，根据ID从数据库重新加载完整的User实体。
3. 把表单中修改的字段赋值给原始实体，直接保存。

控制器代码示例：

@PostMapping("/edit")
public String submitEditForm(@ModelAttribute User updatedUser) {
    // 从数据库加载包含完整字段的原始用户
    User originalUser = userRepository.findById(updatedUser.getId()).orElseThrow();
    // 只复制允许修改的字段，保留原始的resetPassword和consents
    originalUser.setEmail(updatedUser.getEmail());
    originalUser.setName(updatedUser.getName());
    originalUser.setSurname(updatedUser.getSurname());
    originalUser.setPhone(updatedUser.getPhone());
    originalUser.setPassword(updatedUser.getPassword());
    originalUser.setCountry(updatedUser.getCountry());
    originalUser.setSecurityLevel(updatedUser.getSecurityLevel());
    // 直接保存原始实体，确保不丢失不可修改的字段
    userRepository.save(originalUser);
    return "redirect:/users";
}

这个方案最简洁也最安全，完全不用处理Document的转换逻辑，推荐优先考虑。

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