FastGPT/projects/sandbox_server/test

测试说明

测试类型

1. 单元测试 (test/app.test.ts)

基础的 HTTP 端点测试，无需外部依赖。

bun run test

测试内容：

• /health 健康检查
• /openapi OpenAPI 文档
• Bearer Token 鉴权

2. 集成测试 (test/integration/)

测试与真实 Sealos API 的集成，需要配置环境变量。

配置步骤

1. 复制环境变量模板：

cp test/.env.test.template test/.env.test.local

2. 编辑 test/.env.test.local，填写真实配置：

# 服务器配置
PORT=3000
TOKEN=your-api-token

# Sealos 配置（使用测试环境）- 提供 SEALOS_KC 后集成测试自动运行
SEALOS_BASE_URL=https://your-sealos-api.com
SEALOS_KC=your-kubeconfig-token

# 测试镜像
TEST_IMAGE=nginx:alpine
TEST_SANDBOX_IMAGE=ghcr.io/your-org/sandbox-server:latest

3. 运行测试（集成测试会自动运行，如果配置了 SEALOS_KC）：

bun run test

测试内容

容器生命周期测试 (test/integration/container.test.ts)

• ✅ 创建容器
• ✅ 获取容器信息
• ✅ 暂停容器
• ✅ 启动容器
• ✅ 删除容器
• ✅ 幂等性测试（重复创建、删除不存在的容器）

沙盒操作测试 (test/integration/sandbox.test.ts)

• ✅ 健康检查
• ✅ 执行简单命令
• ✅ 捕获 stdout/stderr
• ✅ 工作目录设置
• ✅ 管道命令
• ✅ 多行脚本
• ✅ 错误处理

运行测试

仅运行单元测试

bun run test:run

运行所有测试（包括集成测试）

# 确保已配置 .env.test.local 并提供 SEALOS_KC
bun run test

运行特定测试文件

bun run test test/integration/container.test.ts

查看测试覆盖率

bun run test -- --coverage

注意事项

集成测试注意事项

1. 使用测试环境

   • 不要在生产环境运行集成测试
   • 确保有足够的资源配额

2. 清理资源

   • 测试会自动清理创建的容器
   • 如果测试中断，可能需要手动清理

3. 网络要求

   • 需要能访问 Sealos API
   • 需要能拉取测试镜像

4. 超时设置

   • 容器启动可能需要 60-90 秒
   • 某些测试设置了较长的超时时间

环境变量优先级

1. .env.test.local - 本地测试配置（不提交到 git）
2. 默认值 - 使用 mock 数据

跳过集成测试

如果 SEALOS_KC 未提供，集成测试会自动跳过。这样可以避免意外运行集成测试。

故障排查

测试失败：认证错误

• 检查 SEALOS_KC 是否有效
• 确认 token 有足够的权限

测试失败：超时

• 增加测试超时时间
• 检查网络连接
• 确认 Sealos 服务正常

测试失败：容器创建失败

• 检查资源配额
• 确认镜像可访问
• 查看 Sealos 日志

示例

运行完整测试流程

# 1. 配置环境变量
cp test/.env.test.template test/.env.test.local
# 编辑 test/.env.test.local

# 2. 运行测试（集成测试会自动运行）
bun run test