使用Spring Boot与Spring MVC模板引擎时，表单输入字段无法显示的问题咨询

AI 小北

2026-4-30

排查Spring MVC表单输入框不显示的问题

嘿，刚上手Spring Boot和Spring MVC标签遇到这种问题很正常，我帮你梳理几个最常见的排查方向，一步步来解决：

1. 先确认Spring MVC标签库已正确引入

这是最容易漏掉的一步！在你的JSP页面顶部，必须加上标签库声明，否则<form:input>这些标签根本不会被Spring解析，自然不会渲染成输入框：

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

如果没加这个，页面里的<form:input>会被当作普通的未知标签，浏览器可能直接忽略或者只显示标签文本。

2. 检查Model中是否传入了`language`对象

Spring MVC的表单标签需要绑定一个Model对象（也就是你指定的modelAttribute="language"），如果控制器里没有把这个对象放到Model中，标签无法找到绑定的数据源，就不会渲染输入框。

在你的控制器方法里，一定要添加这行代码：

// 假设你有一个Language实体类
model.addAttribute("language", new Language());

比如展示表单的GET方法应该是这样的：

@GetMapping("/add-language")
public String showLanguageForm(Model model) {
    // 把空的Language对象放到Model里，供表单标签绑定
    model.addAttribute("language", new Language());
    return "your-form-view-name"; // 对应你的JSP页面名称
}

3. 验证实体类的属性和方法是否符合要求

你的Language实体类必须满足两个条件：

拥有和表单path属性完全匹配的字段（name、creator、currentVersion）
每个字段都有对应的getter和setter方法，并且要有一个无参构造器

举个正确的实体类示例：

public class Language {
    private String name;
    private String creator;
    // 版本号用Double或Integer都可以，根据你的需求来
    private Double currentVersion;

    // 必须要有无参构造器，Spring需要用它来实例化对象
    public Language() {}

    // 所有字段的getter和setter
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getCreator() {
        return creator;
    }

    public void setCreator(String creator) {
        this.creator = creator;
    }

    public Double getCurrentVersion() {
        return currentVersion;
    }

    public void setCurrentVersion(Double currentVersion) {
        this.currentVersion = currentVersion;
    }
}

如果缺少getter/setter或者无参构造器，Spring无法完成数据绑定，标签就不会渲染输入框。

4. 检查JSP相关依赖是否齐全

如果是Spring Boot项目，默认不包含JSP的支持依赖，你需要在pom.xml（Maven）或build.gradle（Gradle）中添加对应的依赖：

Maven依赖：

<dependencies>
    <!-- Spring Boot Web核心 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- JSP解析器 -->
    <dependency>
        <groupId>org.apache.tomcat.embed</groupId>
        <artifactId>tomcat-embed-jasper</artifactId>
        <scope>provided</scope>
    </dependency>

    <!-- JSTL标签库 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>jstl</artifactId>
    </dependency>
</dependencies>

没有这些依赖的话，JSP页面无法被正确解析，Spring MVC标签也不会生效。

5. 排查前端样式是否隐藏了输入框

有时候输入框其实已经渲染出来了，只是被CSS样式隐藏了。你可以右键页面→“检查元素”，看看<form:input>对应的HTML元素是否存在，有没有被设置display: none或者visibility: hidden之类的样式。

如果普通的HTML输入框（比如<input type="text" name="name">）能显示，那问题肯定出在Spring MVC标签的配置上；如果普通输入框也不显示，那就要检查页面的其他代码或者样式了。

先按这个顺序排查，大部分情况下都是前三个步骤中的某一个出了问题。如果还是解决不了，可以把你的控制器代码、实体类代码和JSP页面的完整代码贴出来，我再帮你进一步分析。

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

使用Spring Boot与Spring MVC模板引擎时，表单输入字段无法显示的问题咨询

1. 先确认Spring MVC标签库已正确引入 #

2. 检查Model中是否传入了language对象 #

3. 验证实体类的属性和方法是否符合要求 #

4. 检查JSP相关依赖是否齐全 #

Maven依赖： #