Spring MVC测试时遇Thymeleaf错误：供应商更新表单控制器测试问题

看起来你在测试Spring MVC的供应商更新表单控制器时碰到了Thymeleaf相关的错误，我来帮你梳理下可能的问题点和解决思路。

先把你的代码整理清楚：

控制器代码 #

// 获取供应商更新表单
@GetMapping("/{id}")
public String getSupplierUpdateForm(@PathVariable Long id, Model model) {
    if(supplierRepository.findById(id).isPresent()){
        model.addAttribute("supplier",supplierRepository.findById(id).get());
    }
    return "supplier";
}

已编写的测试代码片段 #

@Test
public void testGetSupplierUpdateForm()throws Exception{
    Supplier supplier = new Supplier();
    supplier.setId((long)...

接下来分析常见的Thymeleaf错误原因及解决方法：

1. 测试数据不完整或仓库模拟缺失

Thymeleaf模板渲染时依赖model中的supplier对象及其属性，如果测试中没有正确模拟supplierRepository的返回值，或者Supplier对象缺少模板中用到的属性，就会触发模板渲染错误。

解决方法：用Mockito模拟仓库行为，确保返回完整的Supplier对象，同时给测试环境配置Thymeleaf视图解析器。完善后的测试代码示例：

@Mock
private SupplierRepository supplierRepository;

@InjectMocks
private SupplierController supplierController;

private MockMvc mockMvc;

@BeforeEach
void setUp() {
    MockitoAnnotations.openMocks(this);
    // 配置Thymeleaf视图解析器，确保测试能正确处理模板
    ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
    SpringTemplateEngine templateEngine = new SpringTemplateEngine();
    TemplateResolver templateResolver = new ClassLoaderTemplateResolver();
    templateResolver.setPrefix("templates/"); // 对应你的模板文件路径
    templateResolver.setSuffix(".html");
    templateResolver.setTemplateMode(TemplateMode.HTML);
    templateEngine.setTemplateResolver(templateResolver);
    viewResolver.setTemplateEngine(templateEngine);

    mockMvc = MockMvcBuilders.standaloneSetup(supplierController)
            .setViewResolver(viewResolver)
            .build();
}

@Test
public void testGetSupplierUpdateForm() throws Exception {
    Long testId = 1L;
    Supplier supplier = new Supplier();
    supplier.setId(testId);
    supplier.setName("测试供应商"); // 假设模板用到了name属性，必须提前设置
    supplier.setContactPhone("123456789"); // 模板中用到的其他属性都要对应赋值

    // 模拟仓库查询返回该供应商
    when(supplierRepository.findById(testId)).thenReturn(Optional.of(supplier));

    mockMvc.perform(get("/{id}", testId))
            .andExpect(status().isOk())
            .andExpect(model().attributeExists("supplier"))
            .andExpect(model().attribute("supplier", supplier));
}

2. 模板中的空值引用问题

如果控制器中findById返回空（即对应ID的供应商不存在），model中就不会有supplier属性，此时模板中如果直接写${supplier.name}这类表达式，就会抛出空指针相关的Thymeleaf异常。

解决方法：

• 在模板中添加空值判断，比如用Thymeleaf的安全导航运算符：${supplier?.name}，或者用th:if="${supplier != null}"包裹需要渲染供应商数据的区域
• 或者在控制器中处理空的情况，比如返回错误页面，或者向model中添加一个默认的空Supplier对象

3. 控制器代码优化（避免潜在问题）

你的控制器中两次调用了supplierRepository.findById(id)，这不仅会导致重复查询，还可能在两次调用之间数据发生变化（虽然测试环境不会，但生产环境存在风险）。可以优化成更简洁且安全的写法：

@GetMapping("/{id}")
public String getSupplierUpdateForm(@PathVariable Long id, Model model) {
    supplierRepository.findById(id).ifPresent(supplier -> model.addAttribute("supplier", supplier));
    return "supplier";
}

如果能提供具体的Thymeleaf错误信息（比如控制台的异常栈），就能更精准地定位问题啦！

内容的提问来源于stack exchange，提问作者Emilio Gumayagay