Thymeleaf表单action语法问题：表单编写后浏览器显示异常

从现象来看，页面直接渲染了Thymeleaf的原生表达式（如@{/submit}、*{name}），说明Thymeleaf引擎未对页面进行解析，HTML被当作静态文件处理。以下是具体排查点和解决方法：

1. 缺失Thymeleaf命名空间（核心原因） #

你的HTML代码中<html>标签未声明Thymeleaf命名空间，导致Thymeleaf无法识别th:*属性，直接原样输出表达式。

修复代码：
在<html>标签中添加命名空间：

<html xmlns:th="http://www.thymeleaf.org">

2. 确认Thymeleaf依赖已正确引入 #

如果是Spring Boot项目，需确保构建文件中包含Thymeleaf starter依赖：

Maven（pom.xml） #

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

Gradle（build.gradle） #

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

3. 控制器需返回逻辑视图而非静态文件 #

确保Spring控制器未使用@ResponseBody注解，且返回的是视图名称（对应src/main/resources/templates下的HTML文件），而非直接返回静态资源路径。

示例控制器代码：

@Controller
public class FormController {

    @GetMapping("/form")
    public String showForm(Model model) {
        model.addAttribute("person", new Person()); // 必须将person对象传入模型
        return "form"; // 对应templates/form.html
    }

    @PostMapping("/submit")
    public String submitForm(@ModelAttribute Person person) {
        // 处理表单提交逻辑
        return "success";
    }
}

4. 确保person对象已传入模型 #

表单使用th:object="${person}"绑定对象，若模型中无person实例，Thymeleaf无法解析字段绑定，也会导致显示异常。需在GET请求方法中提前将Person对象添加到Model中（如上述控制器示例）。

5. 检查Thymeleaf基础配置（可选） #

若自定义了配置，确保application.properties/application.yml中的Thymeleaf配置正确：

application.properties：

spring.thymeleaf.enabled=true
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML

内容的提问来源于stack exchange，提问作者Nunyet Calçada