---
sync_policy: engine_only
---
package {{basePackage}}.controller;

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

import static org.junit.jupiter.api.Assertions.*;

/**
 * {{ModuleName}} 控制器单元测试 — 验证 HTTP 接口的入参校验与响应格式。
 */
@ExtendWith(MockitoExtension.class)
class {{ModuleName}}ControllerTest {

    @InjectMocks
    private Object {{moduleName}}Controller;

    @Mock
    private Object {{moduleName}}Service;

    /**
     * 验证 Spring 上下文加载正常。
     */
    @Test
    void contextLoads() {
        assertNotNull({{moduleName}}Controller);
    }

    // 请按 API 契约补齐接口测试：
    // - 正常请求返回 200 + 预期数据结构
    // - 缺少必填参数返回 400
    // - 未授权访问返回 401/403
    // - 资源不存在返回 404
}