HaHafeng
b47079b387
- feat: ChatService集成DeepSeek-V3实现AI对话（390行） - feat: SessionMemory实现上下文记忆（最近3轮对话，170行） - feat: 意图识别支持REDCap数据查询（关键词匹配） - feat: REDCap数据注入LLM（queryRedcapRecord, countRedcapRecords, getProjectInfo） - feat: 解决LLM幻觉问题（基于真实数据回答，明确system prompt） - feat: 即时反馈（正在查询...提示） - test: REDCap查询测试通过（test0102项目，10条记录，ID 7患者详情） - docs: 创建Phase1.5开发完成记录（313行） - docs: 更新Phase1.5开发计划（标记完成） - docs: 更新MVP开发任务清单（Phase 1.5完成） - docs: 更新模块当前状态（60%完成度） - docs: 更新系统总体设计文档（v2.6） - chore: 删除测试脚本（test-redcap-query-for-ai.ts, check-env-config.ts） - chore: 移除REDCap测试环境变量（REDCAP_TEST_*） 技术亮点： - AI基于REDCap真实数据对话，不编造信息 - 从数据库读取项目配置，不使用环境变量 - 企业微信端测试通过，用户体验良好 测试通过： - 查询项目记录总数（10条） - 查询特定患者详情（ID 7） - 项目信息查询 - 上下文记忆（3轮对话） - 即时反馈提示 影响范围：IIT Manager Agent模块
220 lines
5.0 KiB
Markdown
220 lines
5.0 KiB
Markdown
# Node.js 后端 - 镜像修复记录
|
||
|
||
> **修复时间**：2025-12-24
|
||
> **问题原因**：Docker镜像中缺少config目录
|
||
> **解决方案**：重新构建镜像v1.1
|
||
|
||
---
|
||
|
||
## 🐛 问题描述
|
||
|
||
### 错误信息
|
||
```
|
||
Error: ENOENT: no such file or directory, open '/app/config/agents.yaml'
|
||
```
|
||
|
||
### 根本原因
|
||
- 应用启动时需要读取 `/app/config/agents.yaml` 配置文件
|
||
- Dockerfile v1.0 中只复制了 `dist` 和 `prisma` 目录
|
||
- **遗漏了 `config` 目录**
|
||
|
||
---
|
||
|
||
## ✅ 解决方案
|
||
|
||
### 1. 修改Dockerfile
|
||
|
||
**修改位置1**：构建阶段（第32行）
|
||
```dockerfile
|
||
# 5. 复制本地已编译好的 dist 文件夹（跳过TypeScript编译）
|
||
COPY dist ./dist
|
||
|
||
# 6. 复制配置文件（agents.yaml等）✨ 新增
|
||
COPY config ./config
|
||
```
|
||
|
||
**修改位置2**：运行阶段（第61行）
|
||
```dockerfile
|
||
# 从构建阶段复制产物
|
||
COPY --from=builder --chown=nodejs:nodejs /app/node_modules ./node_modules
|
||
COPY --from=builder --chown=nodejs:nodejs /app/dist ./dist
|
||
COPY --from=builder --chown=nodejs:nodejs /app/package*.json ./
|
||
COPY --from=builder --chown=nodejs:nodejs /app/prisma ./prisma
|
||
COPY --from=builder --chown=nodejs:nodejs /app/config ./config ✨ 新增
|
||
```
|
||
|
||
### 2. 重新构建镜像
|
||
|
||
**构建命令**：
|
||
```bash
|
||
docker build -t crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.1 .
|
||
```
|
||
|
||
**构建结果**：
|
||
- ✅ 构建成功
|
||
- ✅ 耗时：59.4秒
|
||
- ✅ 镜像大小：~186MB（压缩后）
|
||
|
||
### 3. 推送到ACR
|
||
|
||
**推送命令**：
|
||
```bash
|
||
docker push crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.1
|
||
```
|
||
|
||
**推送结果**：
|
||
- ✅ 推送成功
|
||
- ✅ Digest: `sha256:f309cec92d2ebb7fd40c38916980d7fcc2d589e61d10a8875f2976c267eac890`
|
||
|
||
---
|
||
|
||
## 📦 新版本镜像信息
|
||
|
||
### 版本对比
|
||
|
||
| 项目 | v1.0（旧版本） | v1.1（新版本） |
|
||
|------|--------------|--------------|
|
||
| **Dockerfile修改** | ❌ 缺少config | ✅ 包含config |
|
||
| **镜像大小** | 838MB | 838MB（基本一致） |
|
||
| **构建时间** | ~5分钟 | ~1分钟（缓存优化） |
|
||
| **状态** | ❌ 启动失败 | ✅ 待验证 |
|
||
|
||
### 新版本镜像地址
|
||
|
||
**公网地址**（用于本地拉取）：
|
||
```
|
||
crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.1
|
||
```
|
||
|
||
**VPC地址**（SAE部署使用）：
|
||
```
|
||
crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.1
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 下一步操作
|
||
|
||
### 步骤1：登录SAE控制台
|
||
访问：https://sae.console.aliyun.com/
|
||
|
||
### 步骤2：更新应用镜像版本
|
||
|
||
1. 找到应用：`nodejs-backend-test`
|
||
2. 点击【配置管理】→【部署配置】
|
||
3. 找到"镜像设置"部分
|
||
4. 修改镜像版本：
|
||
- 从：`backend-service:v1.0`
|
||
- 改为：`backend-service:v1.1` ✨
|
||
|
||
### 步骤3：保存并重新部署
|
||
|
||
1. 点击【保存】
|
||
2. 点击【重新部署】
|
||
3. 等待3-5分钟
|
||
4. 查看实时日志
|
||
|
||
---
|
||
|
||
## ✅ 预期结果
|
||
|
||
### 成功的日志输出
|
||
|
||
```
|
||
============================================================
|
||
🚀 AI临床研究平台 - 后端服务器启动成功！
|
||
============================================================
|
||
📍 服务地址: http://0.0.0.0:3001
|
||
🔍 健康检查: http://0.0.0.0:3001/health
|
||
📡 API入口: http://0.0.0.0:3001/api/v1
|
||
🌍 运行环境: production
|
||
============================================================
|
||
|
||
[INFO] Server listening at http://0.0.0.0:3001
|
||
[INFO] Config loaded: /app/config/agents.yaml ✅
|
||
[INFO] Database connected successfully
|
||
[INFO] Health check endpoint available
|
||
```
|
||
|
||
### 关键验证点
|
||
|
||
- [x] 应用状态：运行中（绿色）
|
||
- [x] 健康检查：通过（绿色）
|
||
- [x] 日志中出现：`Config loaded: /app/config/agents.yaml` ✅
|
||
- [x] 无ENOENT错误
|
||
|
||
---
|
||
|
||
## 📝 修复总结
|
||
|
||
**问题根源**：Dockerfile不完整，遗漏配置文件
|
||
**修复方式**：添加2行COPY指令
|
||
**影响范围**：仅需重新构建和部署，无需修改代码
|
||
**修复时间**：约5分钟（构建1分钟 + 推送1分钟 + 部署3分钟）
|
||
|
||
---
|
||
|
||
## 🔍 预防措施
|
||
|
||
### 1. Dockerfile检查清单
|
||
|
||
创建完整的文件复制清单：
|
||
```dockerfile
|
||
✅ COPY package*.json ./
|
||
✅ COPY prisma ./prisma/
|
||
✅ COPY dist ./dist/
|
||
✅ COPY config ./config/ # 不要遗漏！
|
||
❓ COPY public ./public/ # 如果有静态文件
|
||
❓ COPY scripts ./scripts/ # 如果有启动脚本
|
||
```
|
||
|
||
### 2. 本地测试流程
|
||
|
||
在推送镜像前，先在本地测试：
|
||
```bash
|
||
# 1. 构建镜像
|
||
docker build -t backend-test:local .
|
||
|
||
# 2. 本地运行测试
|
||
docker run -p 3001:3001 \
|
||
-e DATABASE_URL="..." \
|
||
-e JWT_SECRET="..." \
|
||
backend-test:local
|
||
|
||
# 3. 访问健康检查
|
||
curl http://localhost:3001/health
|
||
|
||
# 4. 确认无错误后再推送
|
||
```
|
||
|
||
### 3. CI/CD集成
|
||
|
||
建议在GitHub Actions中添加：
|
||
```yaml
|
||
- name: Build Docker Image
|
||
run: docker build -t backend:${{ github.sha }} .
|
||
|
||
- name: Test Docker Image
|
||
run: |
|
||
docker run -d -p 3001:3001 backend:${{ github.sha }}
|
||
sleep 10
|
||
curl http://localhost:3001/health
|
||
```
|
||
|
||
---
|
||
|
||
**文档创建时间**：2025-12-24
|
||
**维护人员**：运维团队
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|