Spring MVC+Thymeleaf披萨表单校验失败后，配料复选框div未生成渲染

校验失败后配料区块渲染缺失，核心原因是错误回显分支的Model中缺少配料列表对应的属性：

• 首次通过GET请求访问创建页时，showCreationForm方法会主动向Model中存入basic/meat/veggies/sauce/cheese这些按类型分组的配料属性，Thymeleaf可以正常遍历这些值完成渲染，所以页面元素完整。
• 提交无效披萨名称触发校验错误时，请求进入processCreation的错误分支，直接返回create视图，但这个分支全程没有向Model中添加上述配料列表属性。Thymeleaf执行th:each="ingredient : ${basic}"这类遍历逻辑时，找不到对应的变量值，会直接跳过对应DOM块的渲染，最终出现整个配料选择区消失的现象。

基础修复方式 #

把配料初始化、Model填充的逻辑抽成公共方法，在所有需要返回create视图的分支统一调用：

@Slf4j
@Controller
@RequestMapping("/create")
public class CreatePizzaController {
    /**
     * 公共方法：完成配料初始化、向Model填充按类型分组的配料列表
     */
    private void populateIngredientModel(Model model) {
        List<Ingredient> ingredients = Arrays.asList(
                new Ingredient("CLS22", "Classic base 22cm", Ingredient.Type.BASIC),
                new Ingredient("CLS30", "Classic base 30cm", Ingredient.Type.BASIC),
                new Ingredient("PEPE", "Pepperoni", Ingredient.Type.MEAT),
                new Ingredient("HAM", "Ham", Ingredient.Type.MEAT),
                new Ingredient("CHMPG", "Champignons", Ingredient.Type.VEGGIES),
                new Ingredient("CUCU", "Cucumbers", Ingredient.Type.VEGGIES),
                new Ingredient("PARM", "Parmesan cheese", Ingredient.Type.CHEESE),
                new Ingredient("MOZ", "Mozzarella cheese", Ingredient.Type.CHEESE),
                new Ingredient("BARBS", "Barbecue sauce", Ingredient.Type.SAUCE),
                new Ingredient("TOMAS", "Tomato sauce", Ingredient.Type.SAUCE)
        );
        Ingredient.Type[] types = Ingredient.Type.values();
        for(Ingredient.Type type: types){
            model.addAttribute(type.toString().toLowerCase(), filterByType(ingredients, type));
        }
    }

    @GetMapping
    public String showCreationForm(Model model){
        // 调用公共方法填充配料属性
        populateIngredientModel(model);
        model.addAttribute("create", new Pizza());
        return "create";
    }

    @PostMapping
    public String processCreation(@Valid @ModelAttribute("create") Pizza pizza, BindingResult result, Model model){
        if(result.hasErrors()){
            // 错误回显时统一填充配料属性，保证视图渲染有对应变量
            populateIngredientModel(model);
            return "create";
        }
        log.info("Processing creation: " + pizza);
        return "redirect:/orders/current";
    }

    private List<Ingredient> filterByType(List<Ingredient> ingredients, Ingredient.Type type) {
        List<Ingredient> filtered = new ArrayList<>();
        for (Ingredient ingredient:ingredients){
            if(ingredient.getType() == type){
                filtered.add(ingredient);
            }
        }
        return filtered;
    }
}

更优雅的优化方式 #

可以直接用@ModelAttribute注解标记上述填充Model的方法，只要请求进入当前控制器，框架就会自动把方法的返回值存入Model，不需要在每个请求分支手动调用：

// 该方法会在当前控制器的所有请求处理方法执行前自动运行，自动完成Model属性填充
@ModelAttribute
public void populateIngredientModel(Model model) {
    List<Ingredient> ingredients = Arrays.asList(
            // 原有配料初始化逻辑保持不变
    );
    Ingredient.Type[] types = Ingredient.Type.values();
    for(Ingredient.Type type: types){
        model.addAttribute(type.toString().toLowerCase(), filterByType(ingredients, type));
    }
}

这种方式从根源上避免了后续新增返回create视图的分支时，漏加Model属性的问题。

• 遇到Thymeleaf渲染缺失问题时，不需要依赖断点调试，直接在返回视图的分支加日志，打印当前Model中所有的属性名，对比正常访问、错误回显两种场景下的属性差异，就能快速定位缺失的变量。
• Thymeleaf对表达式中不存在的变量默认是静默跳过不渲染，不会抛出明显的运行时异常，这也是这类问题排查难度高的核心原因。如果需要更严格的校验，可以开启Thymeleaf的严格模型访问配置，变量不存在时直接抛出异常，快速暴露问题。

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