如何在Thymeleaf表单字段中传入null值并解决Spring类型转换错误

错误根因 #

你的报错核心是Spring MVC参数绑定阶段，收到的parent_id值为字符串"null"，而非真正的空值，尝试将字符串"null"转为Integer类型时触发了数字格式化异常。

解决方案 #

方案1：控制器局部参数绑定处理（最便捷，无全局影响） #

直接在你的TextController中添加@InitBinder方法，专门处理该控制器下的Integer类型参数转换：

import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.InitBinder;
import java.beans.PropertyEditorSupport;

@Controller
public class TextController {
    // 原有代码保持不变
    
    @InitBinder
    public void initBinder(WebDataBinder binder) {
        binder.registerCustomEditor(Integer.class, new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) {
                // 空字符串、空白字符、字符串"null"都转为null
                if (text == null || text.trim().isBlank() || "null".equalsIgnoreCase(text.trim())) {
                    setValue(null);
                    return;
                }
                setValue(Integer.parseInt(text.trim()));
            }
        });
    }
}

方案2：全局转换器（适合全项目统一处理） #

自定义Spring转换器，全局处理字符串转Integer的空值场景：

1. 新建转换器类

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

@Component
public class StringToIntegerConverter implements Converter<String, Integer> {
    @Override
    public Integer convert(String source) {
        if (source == null || source.trim().isBlank() || "null".equalsIgnoreCase(source.trim())) {
            return null;
        }
        return Integer.valueOf(source.trim());
    }
}

Spring Boot项目会自动识别@Component注解的转换器并注册，非Spring Boot项目可通过实现WebMvcConfigurer的addFormatters方法手动注册。

方案3：前端Thymeleaf层面处理（从源头避免传字符串"null"） #

如果你在表单中使用了th:field绑定parent_id做隐藏提交，可指定空值时输出空字符串而非默认的"null"：

<!-- 把parent_id隐藏域改成如下写法 -->
<input type="hidden" th:field="*{parent_id}" th:value="${text.parent_id} ?: ''" />

同时修正你现有insertText.html中parent_id展示逻辑的优先级问题，否则永远不会显示original：

<!-- 修改前 -->
<p th:text="'parent_id' + ${text.parent_id} ?: 'original'" />
<!-- 修改后（加括号调整运算符优先级） -->
<p th:text="'parent_id: ' + (${text.parent_id} ?: 'original')" />

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