admin/DEPLOY_AMT_FEATURE.md
lvfengfree fd124d1017 feat: 添加AMT批量管理凭证功能
- 功能:AMT凭证的增删改查管理
- 支持设置默认凭证
- 支持单个和批量测试凭证连接
- 数据库表:amt_credential
- 后端:
  * AmtCredential实体类
  * AmtCredentialMapper
  * AmtCredentialService业务逻辑
  * AmtCredentialController控制器
  * 使用Result统一返回格式
- 前端:
  * AMT设置页面重构
  * 凭证列表展示(分页、搜索)
  * 添加/编辑凭证弹窗
  * 批量测试功能
  * API接口封装
- 部署脚本:
  * init_amt_credential_table.bat - 初始化数据库
  * test_amt_api.bat - 测试API接口
  * rebuild_and_start_backend.bat - 重新编译后端
- 文档:
  * AMT_CREDENTIAL_FEATURE.md - 功能说明
  * DEPLOY_AMT_FEATURE.md - 部署说明
2026-03-01 10:55:11 +08:00

2.0 KiB

AMT 凭证功能部署说明

问题修复

修复了 404 错误,主要问题:

  1. 控制器返回格式不统一 - 已改用 Result
  2. 返回代码不匹配 - 已改为 "0000"
  3. API 路径前缀问题 - 已移除 /api 前缀

部署步骤

1. 初始化数据库表

init_amt_credential_table.bat

2. 重启后端服务

停止当前后端服务,然后重新启动:

cd backend
mvn spring-boot:run

或使用批处理脚本:

start_backend.bat

3. 清除浏览器缓存

Ctrl + Shift + Delete 清除浏览器缓存

4. 访问页面

登录系统后,访问:系统设置 > AMT设置

API 端点

所有 API 端点(无需 /api 前缀):

  • GET /amt/credential/list - 分页查询凭证列表
  • GET /amt/credential/all - 获取所有启用的凭证
  • GET /amt/credential/{id} - 根据ID获取凭证
  • POST /amt/credential - 创建凭证
  • PUT /amt/credential/{id} - 更新凭证
  • DELETE /amt/credential/{id} - 删除凭证
  • PUT /amt/credential/{id}/default - 设置默认凭证
  • POST /amt/credential/{id}/test - 测试凭证连接
  • POST /amt/credential/batch-test - 批量测试凭证

测试 API

运行测试脚本:

test_amt_api.bat

或手动测试:

curl -X GET "http://localhost:8080/amt/credential/list?page=1&size=10"

常见问题

Q: 仍然显示 404 错误

A: 确保后端服务已重启,并且数据库表已创建

Q: 返回数据格式错误

A: 检查后端是否使用了最新的代码(使用 Result 类)

Q: 无法创建凭证

A: 检查数据库连接和表结构是否正确

验证清单

  • 数据库表 amt_credential 已创建
  • 后端服务已重启
  • 浏览器缓存已清除
  • 可以访问 AMT 设置页面
  • 可以查看凭证列表
  • 可以添加新凭证
  • 可以编辑凭证
  • 可以删除凭证
  • 可以测试凭证连接
  • 可以批量测试凭证