Spring Boot药品绑定错误：字符串转Long类型失败排查

问题原因 #

Spring MVC默认的参数绑定逻辑会把关联实体集合（比如Patient类的Set<Drug>字段）的前端输入当作实体主键（通常是Long类型）处理，但你这里前端传的是药品名称字符串（如panadol），而非Drug的ID，所以框架尝试将字符串转Long时触发NumberFormatException，最终抛出BindException。

解决方案 #

方案1：自定义PropertyEditor（传统方式） #

编写自定义属性编辑器，将前端传来的药品名称字符串转换为对应的Drug实体，再绑定到Patient对象上。

// 自定义PropertyEditor，负责字符串转Drug
public class DrugPropertyEditor extends PropertyEditorSupport {
    private final DrugRepository drugRepo;

    public DrugPropertyEditor(DrugRepository drugRepo) {
        this.drugRepo = drugRepo;
    }

    @Override
    public void setAsText(String drugName) throws IllegalArgumentException {
        // 根据名称从数据库查询Drug，不存在则创建新实例
        Drug drug = drugRepo.findByName(drugName);
        if (drug == null) {
            drug = new Drug();
            drug.setName(drugName);
        }
        setValue(drug);
    }
}

// 在控制器中注册该编辑器
@Controller
public class PatientController {
    private final DrugRepository drugRepo;

    public PatientController(DrugRepository drugRepo) {
        this.drugRepo = drugRepo;
    }

    @InitBinder
    public void initDrugBinder(WebDataBinder binder) {
        binder.registerCustomEditor(Drug.class, new DrugPropertyEditor(drugRepo));
    }

    // 处理表单提交的方法
    @PostMapping("/patients")
    public String savePatient(@ModelAttribute Patient patient, BindingResult result) {
        if (result.hasErrors()) {
            // 返回表单页面展示错误
            return "patient-form";
        }
        // 保存Patient实体
        patientRepository.save(patient);
        return "redirect:/patients";
    }
}

方案2：使用Converter（Spring 3+推荐） #

实现Spring的Converter接口，完成字符串到Drug的转换，这种方式更灵活，支持全局注册。

// 自定义Converter组件
@Component
public class StringToDrugConverter implements Converter<String, Drug> {
    private final DrugRepository drugRepo;

    public StringToDrugConverter(DrugRepository drugRepo) {
        this.drugRepo = drugRepo;
    }

    @Override
    public Drug convert(String drugName) {
        Drug drug = drugRepo.findByName(drugName);
        if (drug == null) {
            drug = new Drug();
            drug.setName(drugName);
        }
        return drug;
    }
}

// 注册Converter（Spring Boot中@Component会自动注册，手动注册可如下配置）
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    private final StringToDrugConverter stringToDrugConverter;

    public WebMvcConfig(StringToDrugConverter stringToDrugConverter) {
        this.stringToDrugConverter = stringToDrugConverter;
    }

    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(stringToDrugConverter);
    }
}

注意事项 #

• 确保DrugRepository中实现了findByName(String name)方法，根据实际业务调整查询逻辑
• 如果不允许创建新的Drug实体，可以在转换时抛出IllegalArgumentException，并在BindingResult中捕获错误提示用户
• 处理表单提交时，一定要通过BindingResult校验绑定错误，避免直接抛出异常

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