AIclinicalresearch/测试和启动.md

系统启动和测试指南

🚀 快速启动

1. 启动后端服务

打开第一个终端：

cd d:\MyCursor\AIclinicalresearch\backend
npm run dev

预期输出：

🚀 AI临床研究平台 - 后端服务器启动成功！
📍 服务地址: http://localhost:3001
🔍 健康检查: http://localhost:3001/health

如果报错，检查：

• ✅ PostgreSQL是否运行？（Docker: docker ps）
• ✅ Redis是否运行？（Docker: docker ps）
• ✅ .env文件是否配置了API Keys？

---

2. 启动前端服务

打开第二个终端：

cd d:\MyCursor\AIclinicalresearch\frontend
npm run dev

预期输出：

  VITE v6.x.x  ready in xxx ms

  ➜  Local:   http://localhost:3000/
  ➜  Network: use --host to expose

---

3. 访问系统

打开浏览器访问：http://localhost:3000/

---

🔧 常见问题排查

问题1：获取项目列表失败

原因： 后端服务未启动或数据库连接失败

解决方案：

1. 检查后端是否启动：访问 http://localhost:3001/health
2. 检查数据库是否运行：

   docker ps
   # 应该看到postgres和redis容器在运行
   

3. 如果数据库未启动：

   cd d:\MyCursor\AIclinicalresearch
   docker-compose up -d
   

---

问题2：创建项目失败（500错误）

原因： 数据库表未创建或后端代码错误

解决方案：

步骤1：检查数据库表是否存在

cd d:\MyCursor\AIclinicalresearch\backend
npx prisma studio
# 打开Prisma Studio，检查是否有Project表

步骤2：如果表不存在，运行迁移

cd d:\MyCursor\AIclinicalresearch\backend
npx prisma migrate dev

步骤3：查看后端日志

• 在运行npm run dev的终端中查看错误日志
• 通常会显示具体的错误原因

---

问题3：API请求404

原因： 代理配置或路由问题

检查清单：

1. ✅ 后端启动在3001端口
2. ✅ 前端启动在3000端口
3. ✅ vite.config.ts中配置了代理
4. ✅ API路由正确注册

---

📋 完整启动检查清单

前置条件

• Docker Desktop已安装并运行
• Node.js已安装（v18+）
• PostgreSQL容器已启动
• Redis容器已启动
• 后端依赖已安装（npm install）
• 前端依赖已安装（npm install）
• 后端.env文件已配置API Keys
• 数据库迁移已完成（prisma migrate dev）

启动顺序

1. 启动Docker容器（PostgreSQL + Redis）
2. 启动后端服务（3001端口）
3. 启动前端服务（3000端口）
4. 访问浏览器测试

---

🧪 测试流程

1. 测试后端健康检查

# 在浏览器或使用curl
curl http://localhost:3001/health

预期响应：

{
  "status": "ok",
  "database": "connected",
  "timestamp": "2025-10-10T..."
}

2. 测试获取智能体列表

curl http://localhost:3001/api/v1/agents

预期响应：

{
  "success": true,
  "data": [
    {
      "id": "topic-evaluation",
      "name": "选题评价智能体",
      ...
    }
  ]
}

3. 测试前端页面

1. 访问 http://localhost:3000/
2. 应该看到首页和12个智能体卡片
3. 创建新项目
4. 选择"选题评价智能体"进入对话

---

💡 调试技巧

查看后端日志

后端使用Pino日志，启动时会显示所有请求和错误

查看前端控制台

按F12打开开发者工具，查看：

• Console：JavaScript错误
• Network：API请求状态

查看数据库

cd d:\MyCursor\AIclinicalresearch\backend
npx prisma studio
# 在浏览器中查看和编辑数据库内容

---

🆘 获取帮助

如果以上方法都无法解决问题，请提供：

1. 后端终端的完整日志
2. 前端浏览器控制台的错误信息
3. 访问 http://localhost:3001/health 的响应
4. docker ps 的输出