从基础到进阶：Spring Boot + Thymeleaf 整合开发中的常见坑与界面优化

从基础到进阶：Spring Boot + Thymeleaf 整合开发中的常见坑与界面优化

一、前言

在使用 Spring Boot + Thymeleaf 搭建 Web 项目的过程中，很多初学者都会碰到类似这样的报错：

MissingServletRequestParameterException: 
Required request parameter 'xxx' for method parameter type XXX is not present

这是一个非常常见的异常——后端要求某个必填参数，但前端没传或方式不对。另外，还有一些同学会为了界面的美观度而发愁，不知道怎么在原有页面基础上做一些轻量级改动，使页面更好看。

本文将从 基础知识（Spring MVC 请求参数绑定、Thymeleaf 表单提交等）讲起，结合你在项目中遇到的实际错误，由浅入深地分析问题成因和解决方案，并展示如何优化你的支付页面。让我们一起来看看吧～

---

二、Spring Boot MVC 基础：请求与响应

1. Spring Boot Controller

在 Spring MVC 中，所有的路由请求都会映射到某个 Controller 上的方法上。比如：

@Controller
@RequestMapping("/sales")
public class SaleController {
   

    @PostMapping("/create")
    public String createSale(@RequestParam Long productId,
                             @RequestParam Integer quantity,
                             Model model) {
   
        // ... 处理逻辑 ...
        return "someView";
    }
}

• @Controller：表示这是一个控制器，负责处理前端 HTTP 请求。
• @RequestMapping("/sales")：给控制器加一个统一的访问前缀 /sales。
• @PostMapping("/create")：表示这个方法只处理 POST 请求，并且路由路径是 /sales/create。
• @RequestParam Long productId：表示必须从请求中（Query String 或表单等）获取名为 productId 的参数，并且转换成 Long。如果前端没有传该参数或者类型转换失败，就会报错。

2. 为什么会出现 MissingServletRequestParameterException

当后端方法明确要求 @RequestParam("xxx") 时，如果前端并没有传这个参数，那么 Spring 由于找不到值，就会抛出 MissingServletRequestParameterException，意思是「你没给我这个必需的请求参数」。这在实际开发中非常常见：写后端时，我们常常会把必需参数写成 @RequestParam；写前端时，一旦忘了在表单或请求中带上这些参数，后端就会报这个错。

---

三、结合你的项目：问题出在哪儿？

假设你有这么一个 SaleController 里：

@PostMapping("/create")
public String createSale(@RequestParam Long productId,
                         @RequestParam Integer quantity,
                         Model model) {
   
    // ... 执行创建销售逻辑 ...
    // 最终跳转到支付页面：
    return "redirect:/payments/new?saleId=" + someSaleId;
}

又有一个 PaymentController 里：

@GetMapping("/new")
public String showPaymentPage(@RequestParam(required = false) Long saleId, Model model) {
   
    // ...
    return "auth/payment"