Spring Boot模板解析错误：访问/products路径出现500异常

问题详情 #

Spring Boot项目中，访问http://localhost:8080可正常加载首页，但点击Products按钮跳转至http://localhost:8080/products时，出现500内部服务器错误。错误核心提示：

模板解析异常，SpringEL表达式${product.id}无法找到com.example.beststore.Model.Product类的'id'属性，该属性可能非公开或无效。

相关代码片段 #

ProductsController.java

@Controller
@RequestMapping("/products")
public class ProductsController {
    @Autowired
    private ProductsRepository repo;

    @GetMapping({"", "/"})
    public String showProductList(Model model) {
        List<Product> products = repo.findAll(Sort.by(Sort.Direction.DESC, "id"));
        model.addAttribute("products", products);
        return "products/index";
    }
}

application.properties

spring.application.name=beststore
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/beststore
spring.datasource.username=root
spring.datasource.password=9874156R
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect

pom.xml依赖

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-validation</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

首页静态文件（resources/static/index.html）

<body>
<div class="container">
  <h1 class="text-center my-4">Welcome to our website</h1>

  <a class="btn btn-primary" href="/products">Products</a>
</div>

Products页面模板（resources/templates/products/index.html）

<body>
<div class="container">
    <h1 class="text-center my-4">Products</h1>

    <a class="btn btn-primary" href="/products/create">Create Product</a>

    <table class="table">
        <thead>
        <tr>
            <th>ID</th>
            <th>Name</th>
            <th>Brand</th>
            <th>Category</th>
            <th>Price</th>
            <th>Image</th>
            <th>Create At</th>
            <th>Action</th>
        </tr>
        </thead>
        <tbody>
        <tr th:each="product : ${products}">
            <td th:text="${product.id}"></td>
            <td th:text="${product.name}"></td>
            <td th:text="${product.brand}"></td>
            <td th:text="${product.category}"></td>
            <td th:text="${product.price} + '$'"></td>
            <td>
                <img th:src="@{'/images/' + ${product.imageFilename}}" alt="..." width="100">
            </td>
            <td th:text="${#dates.format(product.createdAt, 'yyyy-MM-dd')}"></td>
            <td style="white-space: nowrap">
                <a class="btn btn-primary btn-sm" th:href="@{/products/edit(id=${product.id})}">Edit</a>
                <a class="btn btn-danger btn-sm" th:href="@{/products/delete(id=${product.id})}"
                   onclick="return confirm('Are you sure?')">Delete</a>
            </td>
        </tr>
        </tbody>
    </table>
</div>

问题原因 #

Thymeleaf模板通过SpringEL表达式访问对象属性时，严格遵循JavaBean规范，依赖公共的getter方法。出现该错误的核心原因包括：

• Product类的id字段为私有，但未提供公共的getter方法
• 若使用Lombok，未正确添加注解自动生成getter方法
• 字段与getter方法命名不符合JavaBean规范（比如id的getter不是getId()）

解决方案 #

1. 手动添加getter方法 #

如果未使用Lombok，直接在Product类中为所有需要在模板中访问的字段添加公共getter：

import jakarta.persistence.*;
import java.time.LocalDateTime;

@Entity
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String brand;
    private String category;
    private Double price;
    private String imageFilename;
    private LocalDateTime createdAt;

    // id的getter
    public Long getId() {
        return id;
    }

    // name的getter
    public String getName() {
        return name;
    }

    // brand的getter
    public String getBrand() {
        return brand;
    }

    // category的getter
    public String getCategory() {
        return category;
    }

    // price的getter
    public Double getPrice() {
        return price;
    }

    // imageFilename的getter
    public String getImageFilename() {
        return imageFilename;
    }

    // createdAt的getter
    public LocalDateTime getCreatedAt() {
        return createdAt;
    }

    // 若需要修改字段，可添加setter方法
}

2. 正确使用Lombok注解 #

项目已引入Lombok依赖，只需在Product类上添加@Data注解（自动生成所有字段的getter、setter、toString等方法），或至少添加@Getter注解：

import lombok.Data;
import jakarta.persistence.*;
import java.time.LocalDateTime;

@Entity
@Data // 一键生成所有字段的getter、setter等方法
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String brand;
    private String category;
    private Double price;
    private String imageFilename;
    private LocalDateTime createdAt;
}

注意：Spring Boot 3.x版本中，JPA注解需从jakarta.persistence包导入，而非旧版的javax.persistence。

3. 验证命名规范 #

确保字段名与getter方法符合JavaBean规范：

• 字段名以小写字母开头（如id）
• getter方法命名为get[首字母大写的字段名]（如getId()）
• 布尔类型字段的getter命名为is[首字母大写的字段名]（如isEnabled()）

4. 检查组件扫描范围 #

确认Product类所在包（com.example.beststore.Model）在Spring的组件扫描范围内。默认情况下，Spring会扫描启动类所在包及其子包，若Product类不在该范围内，需在启动类添加@ComponentScan指定扫描路径：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ComponentScan;

@SpringBootApplication
@ComponentScan(basePackages = {"com.example.beststore", "com.example.beststore.Model"})
public class BeststoreApplication {
    public static void main(String[] args) {
        SpringApplication.run(BeststoreApplication.class, args);
    }
}

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