Spring与Angular应用场景下的API定义及API测试范围问题咨询

1. 你当前场景下的API到底是什么 #

首先明确：在前后端分离的Web开发场景中，API是前后端预先约定的交互契约，核心是一套标准化的请求-响应规则，和你提到的几个概念的区别如下：

• 不是用户交互的UI界面：UI是用户操作的入口，用户操作后会触发前端代码调用API，二者属于完全独立的层级
• 不是Spring DispatcherServlet：它是Spring内置的请求路由组件，作用是把前端请求转发到对应Controller方法，属于API请求的处理通道，不是API本身
• 不是前端Angular的HTTP服务类：它是前端侧对API调用逻辑的封装，属于API的调用方实现，不是API本身
• Spring Controller是API的后端实现载体：你代码中通过@RequestMapping、@GetMapping等注解定义的请求方法、请求路径、入参规则、响应格式（包括状态码、返回数据结构），合起来就是你们项目中实际使用的API。

对应你给出的示例代码，你们的API就是GET /cards接口：请求方法为GET、路径为/cards、无请求参数、成功时返回200状态码 + Card数组结构的JSON数据。
对应的两段实现代码分别是：

Angular 侧API调用封装 #

getCards(): Observable<Card[]> {
  return this.http.get<Card[]>(this.baseUrl+'cards')
  .pipe(catchError(this.handleError<Card[]>('getCards', [])));
}

Spring 侧API实现 #

@RestController
@RequestMapping("cards")
@AllArgsConstructor(onConstructor = @__(@Autowired))
public class CardControl {
    private final CardService cardService;

    @GetMapping
    public ResponseEntity<List<Card>> getCards(){
        List<Card> cards = cardService.findAll();
        return new ResponseEntity<>(cards, HttpStatus.OK);
    }
}

2. API测试的核心内容与执行位置 #

测试内容 #

API测试核心是验证前面提到的交互契约是否符合预期，覆盖以下维度：

• 功能正确性：正常请求下是否返回符合结构的正确数据、非法参数是否返回约定的错误码和提示、鉴权/权限逻辑是否符合要求（如未登录用户调用是否返回401、无权限用户调用是否返回403）
• 异常容错性：后端依赖（数据库、第三方服务）超时/不可用时，接口是否返回预期的错误提示而不是直接崩溃
• 性能表现：接口响应时间、并发承载能力是否符合业务要求

测试执行位置 #

• 核心API测试优先在后端执行：API的逻辑本质由后端实现，后端侧测试可以直接模拟各种请求场景，不需要依赖前端代码，执行效率更高、覆盖更全面
• 前端侧仅需测试API调用逻辑：属于前端单元测试范畴，只需验证前端封装的调用方法是否请求了正确的路径、能否正确处理正常响应和错误情况，不需要测试API本身的逻辑

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