Spring Boot项目表单提交按钮无法正常工作问题排查

表单无法提交是模板语法错误、控制器参数缺失共同导致的，具体问题：

• 新增主题表单（adminAddTheme.html）
  1. Thymeleaf表单标签库声明位置错误：你把<th:taglib>写在了页面body容器内部，这类标签库声明必须放在html根节点的属性中，放在内容区会导致<form:form>标签无法被正常解析，渲染出的DOM结构异常直接阻断提交逻辑
  2. GET接口未传递表单绑定对象：控制器/admin/addTheme的GET方法没有向Model中存入theme对象，但表单配置了th:object="${theme}"，Thymeleaf解析时找不到绑定对象会抛出模板异常，导致页面功能失效
• 新增文章表单（userAddArticle.html）
  1. 同样存在标签库声明放在body内部的语法错误，导致表单标签解析失败
  2. 表单未配置提交地址：<form:form>标签没有写th:action属性，表单没有目标提交路径，点击按钮不会触发请求
  3. CSRF参数写法错误：隐藏域的name属性直接写name="${_csrf.parameterName}"，普通HTML标签的属性不会被Thymeleaf自动解析变量，最终生成的参数名是字面量${_csrf.parameterName}，会被Spring Security拦截返回403错误
• 控制器逻辑问题
  新增文章的POST接口重定向写法错误，return "redirect:/user/{id}"不会自动替换路径变量，会直接跳转到字面量路径/user/{id}报404；另外新增文章的GET接口没有把路径中的主题id传给模板，模板无法生成正确的提交地址

1. 调整控制器代码 #

@Controller
public class ForumController { // 类名遵循大驼峰命名规范

    @Autowired
    private ThemeRepository themeRepository;

    @Autowired
    private ArticleRepository articleRepository;

    // 省略其他无问题的接口代码

    @GetMapping("/user/addArticle/{id}")
    public String userAddArticle(@PathVariable(value = "id") Long id, Model model) {
        // 把主题id传给模板，用于生成表单提交地址
        model.addAttribute("themeId", id);
        return "userAddArticle";
    }

    @PostMapping("/user/addArticle/{id}")
    public String userAddArticlePost(@PathVariable(value = "id") Long id, @RequestParam String full_text, Model model) {
        ArticleModel article = new ArticleModel(full_text);
        articleRepository.save(article);
        ThemeModel thisTheme = themeRepository.findById(id).orElseThrow();
        thisTheme.getArticles().add(article);
        themeRepository.save(thisTheme);
        // 正确拼接重定向地址
        return "redirect:/user/" + id;
    }

    @GetMapping("/admin/addTheme")
    public String addTheme(Model model) {
        // 给表单传递空的绑定对象
        model.addAttribute("theme", new ThemeModel());
        return "adminAddTheme";
    }

    // 省略其他无问题的接口代码
}

2. 修复新增主题页面模板 #

<!DOCTYPE html>
<!-- 所有标签库声明统一放在html根标签属性上 -->
<html xmlns:th="http://www.thymeleaf.org" xmlns:form="http://www.springframework.org/tags/form">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/css/bootstrap.min.css">
    <title>新增主题</title>
</head>
<body>
<h1 class="text-muted p-2 mt-1">Додати нову тему</h1>
<div class="container mt-5">
    <!-- 删除页面内部错误的th:taglib标签 -->
    <form:form th:action="@{/admin/addTheme}" th:object="${theme}" method="post">
        <input type="text" name="heading" placeholder="Введіть заголовок..." class="form-control mb-2"/>
        <input type="text" name="description" placeholder="Введіть опис..." class="form-control mb-2"/>
        <input type="submit" value="Опублікувати" class="btn btn-info mt-2"/>
    </form:form>
    <a href="/admin" class="btn btn-secondary mt-2">Скасувати</a>
</div>
</body>
</html>

3. 修复新增文章页面模板 #

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org" xmlns:form="http://www.springframework.org/tags/form">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/css/bootstrap.min.css">
    <title>新增文章</title>
</head>
<body>
    <h1 class="text-muted p-2 mt-1">Додати допис</h1>
    <div class="container mt-5">
        <!-- 配置正确的提交地址，传入主题id -->
        <form:form th:action="@{/user/addArticle/{id}(id=${themeId})}" method="POST">
            <!-- 用th:name和th:value让Thymeleaf正确解析CSRF参数 -->
            <input type="hidden" th:name="${_csrf.parameterName}" th:value="${_csrf.token}" />
            <textarea name="full_text" placeholder="Введіть текст" class="form-control"></textarea>
            <button type="submit" class="btn btn-info mt-2">Опублікувати</button>
            <a href="/user" class="btn btn-secondary mt-2">Скасувати</a>
        </form:form>
    </div>
</body>
</html>

• 实体类字段遵循Java驼峰命名规范，将full_text改为fullText，避免后续序列化、参数绑定出现不兼容问题
• ThemeModel的一对多关系建议补充mappedBy属性，由ArticleModel维护外键关联，不要直接在一方配置@JoinColumn，避免产生多余的关联约束
• Repository、类名、接口名统一使用大驼峰命名，比如ThemeRepository、ArticleRepository，符合Spring组件扫描的默认规则，减少莫名的注入失败问题

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