Run any Skill in Manus with one click

$pwd:

backend-test

Name: Backend Test
Author: WnadeyaowuOraganization

// Test Wande-Play backend endpoints and services using JUnit unit tests (BaseServiceTest with @Transactional rollback) and Playwright API specs in the isolated kimi environment (:710N backend, wande-ai-kimi{N} schema, Redis db{N}, wande user without main-DB access). Covers startup, auth token acquisition, positive/negative/auth cases, and TDD red/green workflow. Curl is debug-only and not a PR evidence.

Run Skill in Manus

$ git log --oneline --stat

stars:0

forks:0

updated:May 6, 2026 at 15:32

File Explorer

2 files

SKILL.md

readonly

package.json

"author": "WnadeyaowuOraganization"

"repository": "WnadeyaowuOraganization/.github"

View GitHub Repository

$ install --globalskills.sh

$ download --local

Run Skill in Manus

[HINT] Download the complete skill directory including SKILL.md and all related files

Run any Skill with one click

name

backend-test

description

Test Wande-Play backend endpoints and services using JUnit unit tests (BaseServiceTest with @Transactional rollback) and Playwright API specs in the isolated kimi environment (:710N backend, wande-ai-kimi{N} schema, Redis db{N}, wande user without main-DB access). Covers startup, auth token acquisition, positive/negative/auth cases, and TDD red/green workflow. Curl is debug-only and not a PR evidence.

后端测试

后端改动提 PR 前必须按顺序通过两道强制门（缺一 CI 拦截）：

JUnit 单测（继承 BaseServiceTest）绿 + mvn compile 通过——每个后端 Issue 必做，不过后端起不来。
Playwright API spec（e2e/tests/backend/**/*.spec.ts）绿——每个后端 Issue 必做，断 status/body/落库。

两门证据必须贴 issues/issue-<N>/task.md。纯文档/配置 Issue 可跳，必须在 task.md 显式注明跳过原因。curl 仅作手动 debug，不作 PR 证据。

独立 kimi 环境

每个编程 CC 有独立环境，禁止连主 Dev 环境（:6040）测试：

资源	kimiN 值
后端端口	`710N`（kimi1=7101、kimi2=7102 ...）
前端端口	`810N`（kimi1=8101 ...）
MySQL schema	`wande-ai-kimi{N}`
Redis DB	`db{N}`
DB 用户	`wande`（无主库 `wande-ai` 权限）

环境变量（run-cc.sh 自动注入，禁止硬编码端口）：

BASE_URL_FRONT = http://localhost:810N — 前端地址
BASE_URL_API = http://localhost:710N — 后端API地址

kimiN 端口：backend=710N，frontend=810N（例：kimi5→:7105 / :8105）。Playwright API spec 模板已用 ${BASE_URL_API}，勿改为 localhost:xxxx。硬编码导致 CI/跨 kimi spec 在错误端口运行，必挂。

TDD 红灯先行（强制）

写测试（单测 + Playwright API）
跑测试确认红灯
写实现
跑测试变绿灯
编译 / 打包 / 门禁

跳过红灯 = 容易写过度实现、漏 case。

启动独立后端

cd /data/home/ubuntu/projects/wande-play-kimiN
bash e2e/scripts/start-backend.sh      # 启动 710N，连 kimiN 独立 DB
tail -f logs/sys-info.log              # 启动日志
# 看到 "Started RuoYiApplication" 即就绪（~60s）

拿登录 token

PORT=710N  # 替换 N（后端=710N，前端=810N）
TOKEN=$(curl -s -X POST http://localhost:${PORT}/auth/login \
  -H "Content-Type: application/json" \
  -d '{"tenantId":"000000","clientId":"e5cd7e4891bf95d1d19206ce24a7b32e","grantType":"password","username":"admin","password":"admin123"}' \
  | jq -r '.data.access_token')
echo $TOKEN

curl 手动 debug（非必做、非 PR 证据）

仅用于 health check 或本地快速试探，不要把 curl 结果贴 task.md 当交付证据，也不要作为开发主流程（直接写 Playwright API spec 更快）。必须带 3 个鉴权头，缺任一 → 401 / 租户错乱：

curl -H "Authorization: Bearer $TOKEN" \
     -H "clientid: e5cd7e4891bf95d1d19206ce24a7b32e" \
     -H "tenantId: 000000" \
     http://localhost:${PORT}/wande/xxx/list

后端启动失败：M2 BOM 缺失恢复（2026-04-14 起）

cc-test-env.sh start 会自愈装 ruoyi-common-bom，但若手动跑 mvn spring-boot:run 遇到：

Non-resolvable import POM: ... ruoyi-common-bom:pom:3.0.0
'dependencies.dependency.version' for org.ruoyi:ruoyi-common-* is missing
failure was cached in the local repository → failure cache 阻止重试

恢复步骤（优先用 cc-test-env.sh restart-backend kimi<N> 自愈，不删库）：

# 1. 删失败缓存
rm -rf /home/ubuntu/cc_scheduler/m2/kimi<N>/repository/org/ruoyi/ruoyi-common-bom

# 2. 只重启后端（保前端+DB，省 2-3min 初始化 + token）
bash ~/projects/.github/scripts/cc-test-env.sh restart-backend kimi<N>

# ⚠️ 仅当数据库真正损坏才用 `restart`（它会 DROP DATABASE 重建）

JUnit 单测（有业务分支时才写）

位置

backend/ruoyi-modules/wande-ai/src/test/java/org/ruoyi/wande/<feature>/
└── XxxServiceTest.java

基类

继承 BaseServiceTest（自动配置 MySQL 测试容器 + @Transactional 回滚）：

@SpringBootTest(classes = RuoYiApplication.class)
@Transactional
public abstract class BaseServiceTest { }

写法（Mockito 专注业务规则）

@ExtendWith(MockitoExtension.class)
class ProjectMineServiceTest {
    @Mock ProjectMineMapper mapper;
    @InjectMocks ProjectMineServiceImpl service;

    @Test
    void batchEvaluate_allValid_updatesAllRows() {
        when(mapper.updateById(any())).thenReturn(1);
        service.batchEvaluate(List.of(1L,2L,3L), 1);
        verify(mapper, times(3)).updateById(any());
    }

    @Test
    void batchEvaluate_emptyIds_throws() {
        assertThatThrownBy(() -> service.batchEvaluate(List.of(), 1))
            .isInstanceOf(ServiceException.class);
    }
}

MyBatis-Plus + Mockito 常见卡点

场景	❌ 错误写法	✅ 正确写法	原因
LambdaUpdateWrapper / LambdaQueryWrapper	`when(mapper.update(...，new LambdaUpdateWrapper<>()))`	改用 `UpdateWrapper<>()` / `QueryWrapper<>()`，不试 mock LambdaWrapper	LambdaWrapper 内部用反射拼 SQL，Mockito 无法匹配具体 lambda 对象，when() 永远不触发
Service 方法返回非 void	`doNothing().when(svc).sendMsg(...)`	`when(svc.sendMsg(...)).thenReturn(jsonNode)`	若方法签名是 `JsonNode sendMsg(...)` 而非 `void sendMsg(...)`，stub 必须匹配实际返回值
分页依赖 ServiceImpl 内部 private baseMapper	`when(baseMapper.selectPage(...)).thenReturn(...)`	改用 `assertDoesNotThrow(() -> service.listPage(...))`	`baseMapper` 是 `ServiceImpl` 的 private 字段，无法注入 mock；此时只验证方法不抛异常即可
`PageQuery` 分页参数	`new PageQuery(10, 1)`	确认参数顺序：`new PageQuery(pageNum, pageSize)` 还是 `(pageSize, pageNum)`	MP 分页依赖 `Page(pageNum, pageSize)`，顺序反了查第 N 页数据而非第一页

最小覆盖

Issue 类型	要求
新 Service	创建 `XxxServiceTest`，覆盖核心 CRUD + 业务分支
改已有 Service	补充变更方法的用例
Bug 修复	先写复现 bug 的回归用例（红灯）再修
新 Controller	可选 `XxxControllerTest`（MockMvc）
纯文档 / 配置	可跳过，task.md 注明原因

运行

mvn test -pl ruoyi-modules/wande-ai -Dtest=ProjectMineServiceTest   # 单类
mvn test -pl ruoyi-modules/wande-ai                                 # 模块全量
mvn test                                                            # 全项目

Playwright API（门 2）

每个后端 Issue 至少一个 spec 覆盖核心 endpoint，断 status/body/落库。位置：e2e/tests/backend/api/<module>.ts。

import { test, expect, request } from '@playwright/test';
test('project-mine list 返回分页结构', async () => {
  const api = await request.newContext({ baseURL: BASE_URL_API });
  const login = await api.post('/auth/login', { data: {...} });
  const token = (await login.json()).data.access_token;
  const res = await api.get('/wande/project/mine/list', {
    headers: { Authorization: `Bearer ${token}` },
  });
  expect(res.status()).toBe(200);
  const body = await res.json();
  expect(body.code).toBe(200);
  expect(Array.isArray(body.rows)).toBeTruthy();
});

执行：

cd /data/home/ubuntu/projects/wande-play-kimiN/e2e
npx playwright test tests/backend/api/<module>.ts --workers=1

编译 + 打包门禁（提交前必过）

cd backend
mvn clean compile -Pprod -DskipTests                   # 编译
mvn test -pl ruoyi-modules/wande-ai                    # 模块单测
mvn clean package -Pprod -Dmaven.test.skip=true        # 打包（CI 等价）

失败必修，不管是否与本 Issue 直接相关（否则堵住整个分支 CI）。

权限 / 租户验证

每个 Controller 方法必须有 @SaCheckPermission("wande:xxx:yyy") 或 @SaCheckLogin
多租户隔离走拦截器，但要 curl 用非 000000 租户账号复测一次（回归 #3517 类事故）
看 sys_menu 表的 perms 值与 Controller 注解完全一致

禁止免责语（约束 6）

task.md / PR body 禁止 测试配置待解决 / 待 CI 验证 / 编译通过但未运行测试 等字样，被 quality-gate 拦截。

反模式

❌ 连主 Dev 环境（:6040）跑测试（污染数据）
❌ 只看编译通过就提交，跳过 Playwright API spec
❌ 跳顺序：JUnit 没绿就先写 Playwright API（后端启动不了，白忙）
❌ 只跑 JUnit 不写 Playwright API spec（两道门缺一，CI/quality-gate 会拦）
❌ 只跑 curl 不写 Playwright API spec：curl 不是 PR 证据，CI 不认
❌ Playwright API spec 只写 expect(res.status()).toBe(200) 不断言 body / 不验证 DB 落库
❌ new TableDataInfo<>() 手设字段（前端判失败）
❌ 漏 @SaCheckPermission（任何登录用户都能调）
❌ JUnit 单测不继承 BaseServiceTest（缺 @Transactional 回滚，污染测试库）
❌ 把单测结果写成"通过"不贴证据到 task.md

name

backend-test

description

后端测试

后端改动提 PR 前必须按顺序通过两道强制门（缺一 CI 拦截）：

JUnit 单测（继承 BaseServiceTest）绿 + mvn compile 通过——每个后端 Issue 必做，不过后端起不来。
Playwright API spec（e2e/tests/backend/**/*.spec.ts）绿——每个后端 Issue 必做，断 status/body/落库。

两门证据必须贴 issues/issue-<N>/task.md。纯文档/配置 Issue 可跳，必须在 task.md 显式注明跳过原因。curl 仅作手动 debug，不作 PR 证据。

独立 kimi 环境

每个编程 CC 有独立环境，禁止连主 Dev 环境（:6040）测试：

资源	kimiN 值
后端端口	`710N`（kimi1=7101、kimi2=7102 ...）
前端端口	`810N`（kimi1=8101 ...）
MySQL schema	`wande-ai-kimi{N}`
Redis DB	`db{N}`
DB 用户	`wande`（无主库 `wande-ai` 权限）

环境变量（run-cc.sh 自动注入，禁止硬编码端口）：

BASE_URL_FRONT = http://localhost:810N — 前端地址
BASE_URL_API = http://localhost:710N — 后端API地址

kimiN 端口：backend=710N，frontend=810N（例：kimi5→:7105 / :8105）。Playwright API spec 模板已用 ${BASE_URL_API}，勿改为 localhost:xxxx。硬编码导致 CI/跨 kimi spec 在错误端口运行，必挂。

TDD 红灯先行（强制）

写测试（单测 + Playwright API）
跑测试确认红灯
写实现
跑测试变绿灯
编译 / 打包 / 门禁

跳过红灯 = 容易写过度实现、漏 case。

启动独立后端

cd /data/home/ubuntu/projects/wande-play-kimiN
bash e2e/scripts/start-backend.sh      # 启动 710N，连 kimiN 独立 DB
tail -f logs/sys-info.log              # 启动日志
# 看到 "Started RuoYiApplication" 即就绪（~60s）

拿登录 token

PORT=710N  # 替换 N（后端=710N，前端=810N）
TOKEN=$(curl -s -X POST http://localhost:${PORT}/auth/login \
  -H "Content-Type: application/json" \
  -d '{"tenantId":"000000","clientId":"e5cd7e4891bf95d1d19206ce24a7b32e","grantType":"password","username":"admin","password":"admin123"}' \
  | jq -r '.data.access_token')
echo $TOKEN

curl 手动 debug（非必做、非 PR 证据）

curl -H "Authorization: Bearer $TOKEN" \
     -H "clientid: e5cd7e4891bf95d1d19206ce24a7b32e" \
     -H "tenantId: 000000" \
     http://localhost:${PORT}/wande/xxx/list

后端启动失败：M2 BOM 缺失恢复（2026-04-14 起）

cc-test-env.sh start 会自愈装 ruoyi-common-bom，但若手动跑 mvn spring-boot:run 遇到：

Non-resolvable import POM: ... ruoyi-common-bom:pom:3.0.0
'dependencies.dependency.version' for org.ruoyi:ruoyi-common-* is missing
failure was cached in the local repository → failure cache 阻止重试

恢复步骤（优先用 cc-test-env.sh restart-backend kimi<N> 自愈，不删库）：

# 1. 删失败缓存
rm -rf /home/ubuntu/cc_scheduler/m2/kimi<N>/repository/org/ruoyi/ruoyi-common-bom

# 2. 只重启后端（保前端+DB，省 2-3min 初始化 + token）
bash ~/projects/.github/scripts/cc-test-env.sh restart-backend kimi<N>

# ⚠️ 仅当数据库真正损坏才用 `restart`（它会 DROP DATABASE 重建）

JUnit 单测（有业务分支时才写）

位置

backend/ruoyi-modules/wande-ai/src/test/java/org/ruoyi/wande/<feature>/
└── XxxServiceTest.java

基类

继承 BaseServiceTest（自动配置 MySQL 测试容器 + @Transactional 回滚）：

@SpringBootTest(classes = RuoYiApplication.class)
@Transactional
public abstract class BaseServiceTest { }

写法（Mockito 专注业务规则）

@ExtendWith(MockitoExtension.class)
class ProjectMineServiceTest {
    @Mock ProjectMineMapper mapper;
    @InjectMocks ProjectMineServiceImpl service;

    @Test
    void batchEvaluate_allValid_updatesAllRows() {
        when(mapper.updateById(any())).thenReturn(1);
        service.batchEvaluate(List.of(1L,2L,3L), 1);
        verify(mapper, times(3)).updateById(any());
    }

    @Test
    void batchEvaluate_emptyIds_throws() {
        assertThatThrownBy(() -> service.batchEvaluate(List.of(), 1))
            .isInstanceOf(ServiceException.class);
    }
}

MyBatis-Plus + Mockito 常见卡点

场景	❌ 错误写法	✅ 正确写法	原因
LambdaUpdateWrapper / LambdaQueryWrapper	`when(mapper.update(...，new LambdaUpdateWrapper<>()))`	改用 `UpdateWrapper<>()` / `QueryWrapper<>()`，不试 mock LambdaWrapper	LambdaWrapper 内部用反射拼 SQL，Mockito 无法匹配具体 lambda 对象，when() 永远不触发
Service 方法返回非 void	`doNothing().when(svc).sendMsg(...)`	`when(svc.sendMsg(...)).thenReturn(jsonNode)`	若方法签名是 `JsonNode sendMsg(...)` 而非 `void sendMsg(...)`，stub 必须匹配实际返回值
分页依赖 ServiceImpl 内部 private baseMapper	`when(baseMapper.selectPage(...)).thenReturn(...)`	改用 `assertDoesNotThrow(() -> service.listPage(...))`	`baseMapper` 是 `ServiceImpl` 的 private 字段，无法注入 mock；此时只验证方法不抛异常即可
`PageQuery` 分页参数	`new PageQuery(10, 1)`	确认参数顺序：`new PageQuery(pageNum, pageSize)` 还是 `(pageSize, pageNum)`	MP 分页依赖 `Page(pageNum, pageSize)`，顺序反了查第 N 页数据而非第一页

最小覆盖

Issue 类型	要求
新 Service	创建 `XxxServiceTest`，覆盖核心 CRUD + 业务分支
改已有 Service	补充变更方法的用例
Bug 修复	先写复现 bug 的回归用例（红灯）再修
新 Controller	可选 `XxxControllerTest`（MockMvc）
纯文档 / 配置	可跳过，task.md 注明原因

运行

mvn test -pl ruoyi-modules/wande-ai -Dtest=ProjectMineServiceTest   # 单类
mvn test -pl ruoyi-modules/wande-ai                                 # 模块全量
mvn test                                                            # 全项目

Playwright API（门 2）

每个后端 Issue 至少一个 spec 覆盖核心 endpoint，断 status/body/落库。位置：e2e/tests/backend/api/<module>.ts。

import { test, expect, request } from '@playwright/test';
test('project-mine list 返回分页结构', async () => {
  const api = await request.newContext({ baseURL: BASE_URL_API });
  const login = await api.post('/auth/login', { data: {...} });
  const token = (await login.json()).data.access_token;
  const res = await api.get('/wande/project/mine/list', {
    headers: { Authorization: `Bearer ${token}` },
  });
  expect(res.status()).toBe(200);
  const body = await res.json();
  expect(body.code).toBe(200);
  expect(Array.isArray(body.rows)).toBeTruthy();
});

执行：

cd /data/home/ubuntu/projects/wande-play-kimiN/e2e
npx playwright test tests/backend/api/<module>.ts --workers=1

编译 + 打包门禁（提交前必过）

cd backend
mvn clean compile -Pprod -DskipTests                   # 编译
mvn test -pl ruoyi-modules/wande-ai                    # 模块单测
mvn clean package -Pprod -Dmaven.test.skip=true        # 打包（CI 等价）

失败必修，不管是否与本 Issue 直接相关（否则堵住整个分支 CI）。

权限 / 租户验证

每个 Controller 方法必须有 @SaCheckPermission("wande:xxx:yyy") 或 @SaCheckLogin
多租户隔离走拦截器，但要 curl 用非 000000 租户账号复测一次（回归 #3517 类事故）
看 sys_menu 表的 perms 值与 Controller 注解完全一致

禁止免责语（约束 6）

task.md / PR body 禁止 测试配置待解决 / 待 CI 验证 / 编译通过但未运行测试 等字样，被 quality-gate 拦截。

反模式

❌ 连主 Dev 环境（:6040）跑测试（污染数据）
❌ 只看编译通过就提交，跳过 Playwright API spec
❌ 跳顺序：JUnit 没绿就先写 Playwright API（后端启动不了，白忙）
❌ 只跑 JUnit 不写 Playwright API spec（两道门缺一，CI/quality-gate 会拦）
❌ 只跑 curl 不写 Playwright API spec：curl 不是 PR 证据，CI 不认
❌ Playwright API spec 只写 expect(res.status()).toBe(200) 不断言 body / 不验证 DB 落库
❌ new TableDataInfo<>() 手设字段（前端判失败）
❌ 漏 @SaCheckPermission（任何登录用户都能调）
❌ JUnit 单测不继承 BaseServiceTest（缺 @Transactional 回滚，污染测试库）
❌ 把单测结果写成"通过"不贴证据到 task.md