Spring Boot 1.5.10控制器测试抛出“至少一个JPA元模型必须存在”异常

针对你遇到的应用启动正常但控制器单元测试失败的问题，结合Spring Boot 1.5.x的特性，我给你梳理下最可能的原因和解决步骤：

一、用对测试注解，聚焦控制器测试 #

Spring Boot 1.5.x中，单独测试控制器时不要用全量的@SpringBootTest，这个注解会加载整个应用上下文，容易因为服务层的依赖（比如数据库、第三方服务）未配置导致测试失败。应该用@WebMvcTest，它只会加载控制器和Spring MVC相关的核心组件，更适合单独测试控制器逻辑。

同时，1.5.x版本需要搭配@RunWith(SpringRunner.class)来启动Spring的测试上下文，否则注解不会生效。

二、Mock掉服务层依赖 #

既然你后续要Mock服务层，那测试时必须用@MockBean注解来替换真实的服务实现，这样测试上下文就不会因为找不到服务Bean而启动失败，也能避免调用真实服务的逻辑。

你可以用Mockito的API来定义Mock对象的行为，比如指定方法的返回值。

三、示例代码参考 #

控制器类（示例） #

package com.particles.authservice;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class AuthController {

    private final AuthService authService;

    // 构造注入（推荐方式）
    public AuthController(AuthService authService) {
        this.authService = authService;
    }

    @GetMapping("/api/auth/check")
    public String checkAuth() {
        return authService.getAuthResult();
    }
}

对应的单元测试类 #

package com.particles.authservice;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.test.context.junit4.SpringRunner;
import org.springframework.test.web.servlet.MockMvc;

import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

@RunWith(SpringRunner.class)
// 指定要测试的控制器类，只加载这个控制器的上下文
@WebMvcTest(AuthController.class)
public class AuthControllerTest {

    // 注入MockMvc对象，用来模拟HTTP请求
    @Autowired
    private MockMvc mockMvc;

    // Mock控制器依赖的AuthService
    @MockBean
    private AuthService authService;

    @Test
    public void checkAuth_ShouldReturnValidResponse() throws Exception {
        // 定义Mock服务的行为：调用getAuthResult时返回"Authorized"
        when(authService.getAuthResult()).thenReturn("Authorized");

        // 模拟发送GET请求，然后断言响应状态和内容
        mockMvc.perform(get("/api/auth/check"))
                .andExpect(status().isOk()) // 断言响应状态码200
                .andExpect(content().string("Authorized")); // 断言响应内容
    }
}

四、常见坑点排查 #

• 忘记加@RunWith(SpringRunner.class)：1.5.x版本必须用这个注解来激活Spring测试上下文，否则@WebMvcTest不会生效，测试会报错。
• 请求路径不匹配：确保测试里的请求路径和控制器上的@GetMapping/@PostMapping完全一致，包括前缀（比如控制器上的@RequestMapping("/api")）。
• 未Mock服务层：如果控制器依赖的服务没有被@MockBean标注，测试上下文会尝试加载真实的服务Bean，若真实服务有未配置的依赖（比如数据库），就会导致测试启动失败。
• 用了@SpringBootTest却没配置webEnvironment：如果非要用全量测试，需要加上@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)，但这会加载整个应用，不适合单独测控制器。

按照上面的配置，你应该能解决测试失败的问题，聚焦于验证控制器的请求处理逻辑和响应是否符合预期。

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