Spring Boot页面加载报错：缺少searchForm请求属性（Thymeleaf）

问题根源 #

• Thymeleaf渲染带th:object="${searchForm}"的表单时，要求请求的Model中必须存在名为searchForm的对象实例，用于表单数据绑定与回显
• 你的@GetMapping("/")方法未向Model中添加该对象，导致页面渲染时找不到目标bean
• @PostMapping("/")返回void会触发Spring渲染同名视图，可能引发后续异常

修改方案 #

1. 修正Controller代码

修改PrivacoogleController.java，确保GET请求时向Model注入表单对象，同时优化POST请求的返回逻辑：

package org.privatec.coogle.Controllers;

import org.privatec.coogle.SearchForm;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

@Controller
public class PrivacoogleController {

    @GetMapping("/")
    public String greeting(Model model) {
        // 向Model中添加空的SearchForm实例，供Thymeleaf表单绑定使用
        model.addAttribute("searchForm", new SearchForm());
        return "greeting";
    }
    
    @PostMapping("/")
    public String getPost(SearchForm searchForm) {
        System.out.println(searchForm.getSearch());
        // 提交后重定向到首页，避免刷新页面重复提交表单
        return "redirect:/";
    }
}

2. 可选：添加表单验证（遵循官方指南）

如果需要实现输入合法性校验，给SearchForm.java添加验证注解：

package org.privatec.coogle;

import javax.validation.constraints.NotEmpty;

public class SearchForm {
    @NotEmpty(message = "搜索内容不能为空")
    private String search;
    
    public String getSearch() {
        return search;
    }
    
    public void setSearch(String search) {
        this.search = search;
    }
}

同时更新Controller的POST方法，支持验证逻辑：

import org.springframework.validation.BindingResult;
import javax.validation.Valid;

// ...

@PostMapping("/")
public String getPost(@Valid SearchForm searchForm, BindingResult bindingResult, Model model) {
    if (bindingResult.hasErrors()) {
        // 验证失败，返回原页面并保留错误信息
        return "greeting";
    }
    System.out.println(searchForm.getSearch());
    return "redirect:/";
}

如果使用Maven，需在pom.xml中添加验证依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

关键说明 #

• model.addAttribute("searchForm", new SearchForm())：为Thymeleaf提供表单绑定的目标对象，解决页面渲染时找不到bean的核心问题
• POST请求返回"redirect:/"：采用PRG（Post/Redirect/Get）模式，避免用户刷新页面重复提交表单
• 添加验证注解与BindingResult：实现官方指南中的表单验证逻辑，处理输入合法性校验

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