Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(aia): Complete AIA V2.0 with universal streaming capabilities

Browse Source 
Major Changes:
- Add StreamingService with OpenAI Compatible format
- Upgrade Chat component V2 with Ant Design X integration
- Implement AIA module with 12 intelligent agents
- Update API routes to unified /api/v1 prefix
- Update system documentation

Backend (~1300 lines):
- common/streaming: OpenAI Compatible adapter
- modules/aia: 12 agents, conversation service, streaming integration
- Update route versions (RVW, PKB to v1)

Frontend (~3500 lines):
- modules/aia: AgentHub + ChatWorkspace (100% prototype restoration)
- shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook
- Update API endpoints to v1

Documentation:
- AIA module status guide
- Universal capabilities catalog
- System overview updates
- All module documentation sync

Tested: Stream response verified, authentication working
Status: AIA V2.0 core completed (85%)
This commit is contained in:
HaHafeng
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
Download Patch File Download Diff File Expand all files Collapse all files

335
docs/05-部署文档/12-Node.js后端-SAE部署操作手册.md
View File

@@ -1,42 +1,42 @@
# Node.js <20>𡒊垢 - SAE<41>函蔡<E587BD>滢<EFBFBD><E6BBA2>见<EFBFBD>
> **创建时间**：2025-12-24
> **<EFBFBD>𥕦遣<EFBFBD>園𡢿**嚗?025-12-24
> **<2A>滢<EFBFBD>撖寡情**嚗鐭ode.js <20>𡒊垢<F0A1928A>滚𦛚
> **部署目标**：阿里云 SAE（Serverless应用引擎）
> **预计时间**：30-40分钟
> **<EFBFBD>函蔡<EFBFBD>格<EFBFBD>**嚗𡁻燵<F0A181BB>䔶<EFBFBD> SAE嚗𠄎erverless摨𠉛鍂撘閙<EFBFBD>嚗?
> **憸<EFBFBD>恣<EFBFBD>園𡢿**嚗?0-40<EFBFBD><EFBFBD><EFBFBD>
---
## 📋 前置检查
## <EFBFBD><EFBFBD> <20>滨蔭璉<E894AD><E79289>?
撘<EFBFBD>憪衤<EFBFBD><EFBFBD>㵪<EFBFBD>霂瑞＆霈歹<EFBFBD>
- [x] Docker<65>𨅯<EFBFBD>撌脫綫<E884AB><E7B6AB><EFBFBD>ACR嚗䫤backend-service:v1.0`
- [x] RDS PostgreSQL撌脤<E6928C>蝵脣僎餈<E5838E>宏<EFBFBD>唳旿
- [x] Python微服务已部署（内网地址：`http://172.17.173.66:8000`）
- [x] 环境变量配置清单已准备（见 `11-Node.js后端-SAE部署配置清单.md`）
- [x] Python敺格<EFBFBD><EFBFBD>∪歇<EFBFBD>函蔡嚗<EFBFBD><EFBFBD>蝵穃𧑐<EFBFBD><EFBFBD>嚗䫤http://172.17.173.66:8000`嚗?
- [x] <EFBFBD>臬<EFBFBD><EFBFBD>㗛<EFBFBD><EFBFBD>滨蔭皜<EFBFBD><EFBFBD>撌脣<EFBFBD>憭<EFBFBD><EFBFBD>閫?`11-Node.js<EFBFBD>𡒊垢-SAE<EFBFBD>函蔡<EFBFBD>滨蔭皜<EFBFBD><EFBFBD>.md`嚗?
---
## <20><> 蝚砌<E89D9A>甇伐<E79487><E4BC90>餃<EFBFBD>SAE<41>批<EFBFBD><E689B9>啣僎<E595A3>𥕦遣摨𠉛鍂
### 1.1 进入SAE控制台
### 1.1 餈𥕦<EFBFBD>SAE<EFBFBD>批<EFBFBD><EFBFBD>?
1. <20>枏<EFBFBD>瘚讛<E7989A><E8AE9B>剁<EFBFBD>霈輸䔮嚗冴ttps://sae.console.aliyun.com/
2. 选择地域：**华北2（北京）**
3. 选择命名空间：**cn-beijing:test-airesearch**
2. <EFBFBD>㗇𥋘<EFBFBD>啣<EFBFBD>嚗?*<2A>𤾸<EFBFBD>2嚗<32><E59A97>鈭穿<E988AD>**
3. <EFBFBD>㗇𥋘<EFBFBD>賢<EFBFBD>蝛粹𡢿嚗?*cn-beijing:test-airesearch**
### 1.2 创建新应用
### 1.2 <EFBFBD>𥕦遣<EFBFBD>啣<EFBFBD><EFBFBD>?
1. 点击【创建应用】按钮
2. 填写基本信息：
1. <EFBFBD>孵稬<EFBFBD>𣂼<EFBFBD>撱箏<EFBFBD><EFBFBD>具<EFBFBD>烐<EFBFBD><EFBFBD>?
2. 憛怠<EFBFBD><EFBFBD>箸𧋦靽⊥<EFBFBD>嚗?
```yaml
摨𠉛鍂<EFBFBD>滨妍: nodejs-backend-test
<EFBFBD>函蔡<EFBFBD>孵<EFBFBD>: 摰孵膥<EFBFBD>𨅯<EFBFBD>
```
3. 点击【下一步】
3. <EFBFBD>孵稬<EFBFBD>𣂷<EFBFBD>銝<EFBFBD>甇乓<EFBFBD>?
---
@@ -44,38 +44,38 @@
### 2.1 <20>㗇𥋘<E39787>𨅯<EFBFBD><F0A885AF>交<EFBFBD>
1. 镜像类型：选择 **容器镜像服务（ACR）**
2. 选择实例：**个人版**
3. 选择地域：**华北2（北京）**
1. <EFBFBD>𨅯<EFBFBD>蝐餃<EFBFBD>嚗𡁻<EFBFBD>㗇𥋘 **摰孵膥<E5ADB5>𨅯<EFBFBD><F0A885AF>滚𦛚嚗㇁CR嚗?*
2. <EFBFBD>㗇𥋘摰硺<EFBFBD>嚗?*銝芯犖<E88AAF>?*
3. <EFBFBD>㗇𥋘<EFBFBD>啣<EFBFBD>嚗?*<2A>𤾸<EFBFBD>2嚗<32><E59A97>鈭穿<E988AD>**
### 2.2 <20>滨蔭<E6BBA8>𨅯<EFBFBD>隞枏<E99A9E>霈方<E99C88>
⚠️ **重要**：必须先配置认证，否则无法拉取私有镜像
<EFBFBD>𩤃<EFBFBD> **<EFBFBD>滩<EFBFBD>**嚗𡁜<E59A97>憿餃<E686BF><E9A483>滨蔭霈方<E99C88>嚗<EFBFBD>炏<EFBFBD>蹱<EFBFBD>瘜閙<E7989C><E99699>𣇉<EFBFBD><F0A38789>厰<EFBFBD><E58EB0>?
1. 点击【配置镜像仓库】
2. 填写认证信息：
1. <EFBFBD>孵稬<EFBFBD>鞾<EFBFBD>蝵桅<EFBFBD><EFBFBD>譍<EFBFBD>摨瓐<EFBFBD>?
2. 憛怠<EFBFBD>霈方<EFBFBD>靽⊥<EFBFBD>嚗?
```yaml
Registry<EFBFBD>啣<EFBFBD>: crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com
用户名: gofeng117@163.com
<EFBFBD>冽<EFBFBD><EFBFBD>? gofeng117@163.com
撖<EFBFBD><EFBFBD>: fengzhibo117
```
3. 点击【确定】
3. <EFBFBD>孵稬<EFBFBD>鞟＆摰𠾼<EFBFBD>?
4. <20>孵稬<E5ADB5>鞾<EFBFBD>霂<EFBFBD>恕霂<E68195><E99C82>𡢅<EFBFBD>蝖桐<E89D96>霈方<E99C88><E696B9>𣂼<EFBFBD>
### 2.3 <20>㗇𥋘<E39787>𨅯<EFBFBD>
1. 选择命名空间：**ai-clinical**
2. 选择镜像：**backend-service**
3. 选择镜像版本：**v1.0**
1. <EFBFBD>㗇𥋘<EFBFBD>賢<EFBFBD>蝛粹𡢿嚗?*ai-clinical**
2. <EFBFBD>㗇𥋘<EFBFBD>𨅯<EFBFBD>嚗?*backend-service**
3. <EFBFBD>㗇𥋘<EFBFBD>𨅯<EFBFBD><EFBFBD><EFBFBD>𧋦嚗?*v1.0**
完整镜像地址应显示为：
摰峕㟲<EFBFBD>𨅯<EFBFBD><EFBFBD>啣<EFBFBD>摨娍遬蝷箔蛹嚗?
```
crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.0
```
4. 点击【下一步】
4. <EFBFBD>孵稬<EFBFBD>𣂷<EFBFBD>銝<EFBFBD>甇乓<EFBFBD>?
---
@@ -84,31 +84,31 @@ crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backen
### 3.1 <20>箇<EFBFBD><E7AE87>滨蔭
```yaml
应用实例数: 1
CPU: 1核
内存: 2048 MB（2GB）
摨𠉛鍂摰硺<EFBFBD><EFBFBD>? 1
CPU: 1<EFBFBD>?
<EFBFBD><EFBFBD><EFBFBD>: 2048 MB嚗?GB嚗?
摨𠉛鍂蝐餃<EFBFBD>: Web摨𠉛鍂
```
### 3.2 蝵𤑳<E89DB5><F0A491B3>滨蔭
1. **VPC配置**：
1. **VPC<EFBFBD>滨蔭**嚗?
- VPC ID嚗䫤vpc-2ze055cptkew9c38w4r06`
- 摰匧<E691B0>蝏<EFBFBD><E89D8F>`sg-2zedk6fi8sgmmcwdu7tu`
- 勾选【自动分配公网SLB】：❌ 不勾选（仅内网访问）
- <EFBFBD>暸<EFBFBD>剹<EFBFBD>鞱䌊<EFBFBD>典<EFBFBD><EFBFBD>滚<EFBFBD>蝵騌LB<EFBFBD>𡢅<EFBFBD><EFBFBD>?銝滚㗲<E6BB9A>㚁<EFBFBD>隞<EFBFBD><E99A9E>蝵𤏸挪<F0A48FB8>殷<EFBFBD>
2. **端口配置**：
2. **蝡臬藁<EFBFBD>滨蔭**嚗?
- 摰孵膥蝡臬藁嚗䫤3001`
- <20>讛悅嚗䫤TCP`
### 3.3 <20>臬<EFBFBD><E887AC>㗛<EFBFBD><E3979B>滨蔭
⚠️ **关键步骤**：复制 `11-Node.js后端-SAE部署配置清单.md` 中的环境变量
<EFBFBD>𩤃<EFBFBD> **<EFBFBD>喲睸甇仿炊**嚗𡁜<E59A97><F0A1819C>?`11-Node.js<EFBFBD>𡒊垢-SAE<EFBFBD>函蔡<EFBFBD>滨蔭皜<EFBFBD><EFBFBD>.md` 銝剔<E98A9D><E58994>臬<EFBFBD><E887AC>㗛<EFBFBD>
**方式A：批量导入（推荐）**
**<EFBFBD>孵<EFBFBD>A嚗𡁏鸌<EFBFBD>誩紡<EFBFBD>伐<EFBFBD><EFBFBD>刻<EFBFBD>嚗?*
1. 点击【批量导入】
2. 复制以下内容粘贴：
1. <EFBFBD>孵稬<EFBFBD>鞉鸌<EFBFBD>誩紡<EFBFBD>乓<EFBFBD>?
2. 憭滚<EFBFBD>隞乩<EFBFBD><EFBFBD><EFBFBD>捆蝎䁅斐嚗?
```env
DATABASE_URL=postgresql://airesearch:Xibahe%40fengzhibo117@pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432/ai_clinical_research?connection_limit=18&pool_timeout=10
@@ -134,101 +134,101 @@ PYTHON_SERVICE_URL=http://172.17.173.66:8000
LOG_LEVEL=info
```
3. 点击【确定】
3. <EFBFBD>孵稬<EFBFBD>鞟＆摰𠾼<EFBFBD>?
**方式B：逐个添加**（如果批量导入不可用）
**<EFBFBD>孵<EFBFBD>B嚗𡁻<EFBFBD>𣂷葵瘛餃<EFBFBD>**嚗<><E59A97><EFBFBD>𨀣鸌<F0A880A3>誩紡<E8AAA9>乩<EFBFBD><E4B9A9>舐鍂嚗?
在环境变量表格中逐个添加，参考 `11-Node.js后端-SAE部署配置清单.md` 中的表格。
<EFBFBD>函㴓憓<EFBFBD><EFBFBD><EFBFBD>讛”<EFBFBD>潔葉<EFBFBD>𣂷葵瘛餃<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>?`11-Node.js<EFBFBD>𡒊垢-SAE<EFBFBD>函蔡<EFBFBD>滨蔭皜<EFBFBD><EFBFBD>.md` 銝剔<E98A9D>銵冽聢<E586BD>?
### 3.4 <20>臬𢆡<E887AC>賭誘<E8B3AD>滨蔭
1. 在【启动命令】中填写：
1. <EFBFBD>具<EFBFBD>𣂼鍳<EFBFBD>典𦶢隞扎<EFBFBD>睲葉憛怠<EFBFBD>嚗?
```bash
node dist/server.js
```
**说明**：
- ✅ 不需要 `npm start`（镜像已经编译好）
- ✅ 不需要 `prisma migrate`（数据已导入）
- ✅ 不需要 `prisma generate`（镜像构建时已生成）
**霂湔<EFBFBD>**嚗?
- <EFBFBD>?銝漤<E98A9D>閬?`npm start`嚗<EFBFBD><EFBFBD><EFBFBD>誩歇蝏讐<EFBFBD>霂穃末嚗?
- <EFBFBD>?銝漤<E98A9D>閬?`prisma migrate`嚗<EFBFBD>㺭<EFBFBD>桀歇撖澆<EFBFBD>嚗?
- <EFBFBD>?銝漤<E98A9D>閬?`prisma generate`嚗<EFBFBD><EFBFBD><EFBFBD>𤩺<EFBFBD>撱箸𧒄撌脩<EFBFBD><EFBFBD>琜<EFBFBD>
### 3.5 健康检查配置
### 3.5 <EFBFBD>亙熒璉<EFBFBD><EFBFBD>仿<EFBFBD>蝵?
1. 勾选【启用健康检查】
2. 配置参数：
1. <EFBFBD>暸<EFBFBD>剹<EFBFBD>𣂼鍳<EFBFBD>典<EFBFBD>摨瑟<EFBFBD><EFBFBD>乓<EFBFBD>?
2. <EFBFBD>滨蔭<EFBFBD><EFBFBD>㺭嚗?
```yaml
检查方式: HTTP请求
璉<EFBFBD><EFBFBD>交䲮撘? HTTP霂瑟<EFBFBD>
霂瑟<EFBFBD>頝臬<EFBFBD>: /health
蝡臬藁: 3001
初始延迟: 30秒
检查间隔: 10秒
超时时间: 3秒
不健康阈值: 3次
健康阈值: 2次
<EFBFBD>嘥<EFBFBD>撱嗉<EFBFBD>: 30蝘?
璉<EFBFBD><EFBFBD>仿𡢿<EFBFBD>? 10蝘?
頞<EFBFBD>𧒄<EFBFBD>園𡢿: 3蝘?
銝滚<EFBFBD>摨琿<EFBFBD><EFBFBD>? 3甈?
<EFBFBD>亙熒<EFBFBD><EFBFBD><EFBFBD>? 2甈?
```
**为什么初始延迟设置30秒？**
- Node.js应用启动需要10-15秒
- Prisma Client初始化需要5-10秒
- 数据库连接池建立需要5秒
- 留有余量，避免首次健康检查失败
**銝箔<EFBFBD>銋<EFBFBD><EFBFBD>憪见辣餈蠘挽蝵?0蝘𡜐<E89D98>**
- Node.js摨𠉛鍂<EFBFBD>臬𢆡<EFBFBD><EFBFBD>閬?0-15蝘?
- Prisma Client<EFBFBD>嘥<EFBFBD><EFBFBD>㚚<EFBFBD>閬?-10蝘?
- <EFBFBD>唳旿摨栞<EFBFBD><EFBFBD>交<EFBFBD>撱箇<EFBFBD><EFBFBD><EFBFBD>閬?蝘?
- <EFBFBD>蹱<EFBFBD>雿䠷<EFBFBD>嚗屸<EFBFBD><EFBFBD>漤<EFBFBD>甈∪<EFBFBD>摨瑟<EFBFBD><EFBFBD>亙仃韐?
3. 点击【下一步】
3. <EFBFBD>孵稬<EFBFBD>𣂷<EFBFBD>銝<EFBFBD>甇乓<EFBFBD>?
---
## 📝 第四步：确认配置并部署
## <EFBFBD><EFBFBD> 蝚砍<E89D9A>甇伐<E79487>蝖株恕<E6A0AA>滨蔭撟園<E6929F>蝵?
### 4.1 检查配置摘要
### 4.1 璉<EFBFBD><EFBFBD>仿<EFBFBD>蝵格<EFBFBD>閬?
<EFBFBD>函＆霈日△<EFBFBD>ｇ<EFBFBD>隞𠉛<EFBFBD>璉<EFBFBD><EFBFBD>伐<EFBFBD>
- [x] <20>𨅯<EFBFBD><F0A885AF>啣<EFBFBD>甇<EFBFBD>＆嚗䫤backend-service:v1.0`
- [x] 资源配置正确：1核2GB
- [x] 环境变量数量：21个（可以点击查看详情）
- [x] 韏<EFBFBD><EFBFBD><EFBFBD>滨蔭甇<EFBFBD>＆嚗?<3F>?GB
- [x] <EFBFBD>臬<EFBFBD><EFBFBD>㗛<EFBFBD><EFBFBD>圈<EFBFBD>嚗?1銝迎<E98A9D><E8BF8E>臭誑<E887AD>孵稬<E5ADB5>亦<EFBFBD>霂行<E99C82>嚗?
- [x] <20>亙熒璉<E78692><E79289>亥楝敺<E6A59D><E695BA>`/health`
- [x] <20>臬𢆡<E887AC>賭誘嚗䫤node dist/server.js`
### 4.2 开始部署
### 4.2 撘<EFBFBD>憪钅<EFBFBD>蝵?
1. 点击【创建应用】
2. 等待部署（约3-5分钟）
1. <EFBFBD>孵稬<EFBFBD>𣂼<EFBFBD>撱箏<EFBFBD><EFBFBD>具<EFBFBD>?
2. 蝑匧<EFBFBD><EFBFBD>函蔡嚗<EFBFBD>漲3-5<><35><EFBFBD>嚗?
**部署过程**：
**<EFBFBD>函蔡餈<EFBFBD><EFBFBD>**嚗?
```
1. 拉取镜像（2分钟）
2. 创建容器实例（1分钟）
3. 启动应用（30秒）
1. <EFBFBD>匧<EFBFBD><EFBFBD>𨅯<EFBFBD>嚗?<3F><><EFBFBD>嚗?
2. <EFBFBD>𥕦遣摰孵膥摰硺<EFBFBD>嚗?<3F><><EFBFBD>嚗?
3. <EFBFBD>臬𢆡摨𠉛鍂嚗?0蝘𡜐<E89D98>
4. <20>扯<EFBFBD><E689AF>亙熒璉<E78692><E79289>伐<EFBFBD>30蝘𡜐<E89D98>
```
---
## ✅ 第五步：部署验证
## <EFBFBD>?蝚砌<E89D9A>甇伐<E79487><E4BC90>函蔡撉諹<E69289>
### 5.1 检查应用状态
### 5.1 璉<EFBFBD><EFBFBD>亙<EFBFBD><EFBFBD>函𠶖<EFBFBD>?
1. <20>沒AE摨𠉛鍂<F0A0899B>𡑒”銝哨<E98A9D><E593A8>曉<EFBFBD> `nodejs-backend-test`
2. <20>亦<EFBFBD><E4BAA6>嗆<EFBFBD><E59786><EFBFBD>
- ✅ 实例状态：**运行中**（绿色）
- ✅ 健康检查：**通过**（绿色）
- ❌ 如果显示"异常"或"未通过"，进入第六步排查
- <EFBFBD>?摰硺<E691B0><E7A1BA>嗆<EFBFBD><E59786><EFBFBD>**餈鞱<E9A488>銝?*嚗<>遛<EFBFBD>莎<EFBFBD>
- <EFBFBD>?<3F>亙熒璉<E78692><E79289>伐<EFBFBD>**<2A>朞<EFBFBD>**嚗<>遛<EFBFBD>莎<EFBFBD>
- <EFBFBD>?憒<><E68692><EFBFBD>曄內"撘<>虜"<22>?<3F>芷<EFBFBD>朞<EFBFBD>"嚗諹<E59A97><E8ABB9>亦洵<E4BAA6>剜郊<E5899C>埝䰻
### 5.2 <20>亦<EFBFBD>摰墧𧒄<E5A2A7>亙<EFBFBD>
1. 点击应用名称，进入应用详情
2. 点击【日志】→【实时日志】
3. 查找以下关键信息：
1. <EFBFBD>孵稬摨𠉛鍂<EFBFBD>滨妍嚗諹<EFBFBD><EFBFBD>亙<EFBFBD><EFBFBD>刻祕<EFBFBD>?
2. <EFBFBD>孵稬<EFBFBD>鞉𠯫敹𨰜<EFBFBD>爗<EFBFBD><EFBFBD>𣂼<EFBFBD><EFBFBD>嗆𠯫敹𨰜<EFBFBD>?
3. <EFBFBD>交𪄳隞乩<EFBFBD><EFBFBD>喲睸靽⊥<EFBFBD>嚗?
**✅ 成功的日志示例**：
**<EFBFBD>?<3F>𣂼<EFBFBD><F0A382BC><EFBFBD>𠯫敹㛖內靘?*嚗?
```
============================================================
<EFBFBD><EFBFBD> AI銝游<E98A9D><E6B8B8>𠉛弦撟喳蝱 - <20>𡒊垢<F0A1928A>滚𦛚<E6BB9A>典鍳<E585B8>冽<EFBFBD><E586BD><EFBFBD><EFBFBD>
============================================================
<EFBFBD><EFBFBD> <20>滚𦛚<E6BB9A>啣<EFBFBD>: http://0.0.0.0:3001
🔍 健康检查: http://0.0.0.0:3001/health
<EFBFBD><EFBFBD> <20>亙熒璉<E78692><E79289>? http://0.0.0.0:3001/health
<EFBFBD>摱 API<50>亙藁: http://0.0.0.0:3001/api/v1
<EFBFBD><EFBFBD> 餈鞱<E9A488><E99EB1>臬<EFBFBD>: production
============================================================
@@ -238,32 +238,32 @@ node dist/server.js
[INFO] Health check endpoint available: /health
```
**❌ 失败的日志示例**：
**<EFBFBD>?憭梯揖<E6A2AF><E68F96>𠯫敹㛖內靘?*嚗?
```
[ERROR] Database connection failed: connect ETIMEDOUT
[ERROR] Prisma Client initialization failed
[ERROR] Application startup failed
```
如果看到错误，进入第六步排查。
憒<EFBFBD><EFBFBD><EFBFBD>见<EFBFBD><EFBFBD>躰秤嚗諹<EFBFBD><EFBFBD>亦洵<EFBFBD>剜郊<EFBFBD>埝䰻<EFBFBD>?
### 5.3 <20>瑕<EFBFBD><E79195><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>
1. 在应用详情页，找到【基本信息】
1. <EFBFBD>典<EFBFBD><EFBFBD>刻祕<EFBFBD><EFBFBD>△嚗峕𪄳<EFBFBD>啜<EFBFBD>𣂼抅<EFBFBD>砌縑<EFBFBD>胯<EFBFBD>?
2. 憭滚<E686AD><E6BB9A><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>嚗峕聢撘讐掩隡潘<E99AA1>`http://172.17.x.x:3001`
3. 霈啣<E99C88><E595A3>圈<EFBFBD>蝵脫<E89DB5>獢<EFBFBD>葉
**示例内网地址**：
**蝷箔<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>**嚗?
```
http://172.17.173.88:3001
```
### 5.4 测试健康检查
### 5.4 瘚贝<EFBFBD><EFBFBD>亙熒璉<EFBFBD><EFBFBD>?
在SAE的【Webshell】中执行：
<EFBFBD>沒AE<EFBFBD><EFBFBD><EFBFBD>𨔽ebshell<EFBFBD>睲葉<EFBFBD>扯<EFBFBD>嚗?
```bash
# 测试健康检查
# 瘚贝<EFBFBD><EFBFBD>亙熒璉<EFBFBD><EFBFBD>?
curl http://172.17.173.88:3001/health
# <20><><EFBFBD>餈𥪜<E9A488>嚗𠃍TTP 200嚗㚁<E59A97>
@@ -276,10 +276,10 @@ curl http://172.17.173.88:3001/health
}
```
### 5.5 测试数据库连接
### 5.5 瘚贝<EFBFBD><EFBFBD>唳旿摨栞<EFBFBD><EFBFBD>?
```bash
# 测试用户API（如果有数据）
# 瘚贝<EFBFBD><EFBFBD>冽<EFBFBD>API嚗<EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD><EFBFBD>唳旿嚗?
curl http://172.17.173.88:3001/api/v1/users \
-H "Authorization: Bearer test-token"
@@ -290,68 +290,68 @@ curl http://172.17.173.88:3001/api/v1/users \
## <20>圲 蝚砍<E89D9A>甇伐<E79487><E4BC90><EFBFBD><EFBFBD><EFBFBD>埝䰻嚗<E4B0BB>虾<EFBFBD>㚁<EFBFBD>
### 问题1：健康检查一直失败
### <EFBFBD>桅<EFBFBD>1嚗𡁜<EFBFBD>摨瑟<EFBFBD><EFBFBD>乩<EFBFBD><EFBFBD>游仃韐?
**症状**：应用状态显示"异常"，实例频繁重启
**<EFBFBD><EFBFBD>𠶖**嚗𡁜<E59A97><F0A1819C>函𠶖<E587BD><F0A0B696>遬蝷?撘<>虜"嚗<><E59A97>靘钅<E99D98>蝜<EFBFBD><E89D9C><EFBFBD>?
**排查步骤**：
**<EFBFBD>埝䰻甇仿炊**嚗?
1. **检查日志中的错误信息**：
1. **璉<EFBFBD><EFBFBD>交𠯫敹𦯀葉<EFBFBD><EFBFBD><EFBFBD>霂臭縑<EFBFBD>?*嚗?
```bash
# 在SAE实时日志中查找关键错误
# <EFBFBD>沒AE摰墧𧒄<EFBFBD>亙<EFBFBD>銝剜䰻<EFBFBD>曉<EFBFBD><EFBFBD>桅<EFBFBD>霂?
[ERROR] ...
```
2. **常见原因及解决方案**：
2. **撣貉<EFBFBD><EFBFBD>笔<EFBFBD><EFBFBD>𡃏圾<EFBFBD>單䲮獢?*嚗?
| <20>躰秤靽⊥<E99DBD> | <20>笔<EFBFBD> | 閫<><E996AB><EFBFBD>寞<EFBFBD> |
|---------|------|---------|
| `connect ETIMEDOUT` | 数据库连接超时 | 检查RDS白名单、VPC配置 |
| `authentication failed` | 数据库密码错误 | 检查DATABASE_URL中的密码编码 |
| `ENOENT: no such file or directory` | 启动命令错误 | 确认启动命令为 `node dist/server.js` |
| `Cannot find module 'prisma'` | Prisma Client未生成 | 重新构建镜像 |
| `Port 3001 already in use` | 端口冲突 | 检查容器端口配置 |
| `connect ETIMEDOUT` | <EFBFBD>唳旿摨栞<EFBFBD><EFBFBD>亥<EFBFBD><EFBFBD>?| 璉<><E79289>充DS<44>賢<EFBFBD><E8B3A2>𨰻<EFBFBD><F0A8B0BB>PC<50>滨蔭 |
| `authentication failed` | <EFBFBD>唳旿摨枏<EFBFBD><EFBFBD><EFBFBD><EFBFBD>霂?| 璉<><E79289>主ATABASE_URL銝剔<EFBFBD>撖<EFBFBD><EFBFBD>蝻𣇉<EFBFBD> |
| `ENOENT: no such file or directory` | <EFBFBD>臬𢆡<EFBFBD>賭誘<EFBFBD>躰秤 | 蝖株恕<E6A0AA>臬𢆡<E887AC>賭誘銝?`node dist/server.js` |
| `Cannot find module 'prisma'` | Prisma Client<EFBFBD>芰<EFBFBD><EFBFBD>?| <20>齿鰵<E9BDBF><E9B0B5>遣<EFBFBD>𨅯<EFBFBD> |
| `Port 3001 already in use` | 蝡臬藁<EFBFBD>脩<EFBFBD> | 璉<><E79289>亙捆<E4BA99>函垢<E587BD><E59EA2><EFBFBD>蝵?|
3. **验证数据库连接**：
3. **撉諹<EFBFBD><EFBFBD>唳旿摨栞<EFBFBD><EFBFBD>?*嚗?
```bash
# 在SAE的Webshell中测试
# <EFBFBD>沒AE<EFBFBD><EFBFBD>ebshell銝剜<EFBFBD>霂?
curl -v telnet://pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432
```
### 问题2：镜像拉取失败
### <EFBFBD>桅<EFBFBD>2嚗𡁻<EFBFBD><EFBFBD>𤩺<EFBFBD><EFBFBD>硋仃韐?
**症状**：日志显示 `Failed to pull image`
**<EFBFBD><EFBFBD>𠶖**嚗𡁏𠯫敹埈遬蝷?`Failed to pull image`
**解决方案**：
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
1. 检查ACR认证配置：
- Registry地址是否正确（VPC域名）
- 用户名密码是否正确
1. 璉<EFBFBD><EFBFBD>丕CR霈方<EFBFBD><EFBFBD>滨蔭嚗?
- Registry<EFBFBD>啣<EFBFBD><EFBFBD>臬炏甇<EFBFBD>＆嚗ĀPC<EFBFBD>笔<EFBFBD>嚗?
- <EFBFBD>冽<EFBFBD><EFBFBD>滚<EFBFBD><EFBFBD><EFBFBD>糓<EFBFBD>行迤蝖?
2. 重新配置镜像仓库认证：
- SAE应用详情 → 配置管理 → 镜像设置
2. <EFBFBD>齿鰵<EFBFBD>滨蔭<EFBFBD>𨅯<EFBFBD>隞枏<EFBFBD>霈方<EFBFBD>嚗?
- SAE摨𠉛鍂霂行<EFBFBD> <20>?<3F>滨蔭蝞∠<E89D9E> <20>?<3F>𨅯<EFBFBD>霈曄蔭
- <20>齿鰵颲枏<E9A2B2>霈方<E99C88>靽⊥<E99DBD>
### <20>桅<EFBFBD>3嚗𡁶㴓憓<E3B493><E68693><EFBFBD>𤩺𧊋<F0A4A9BA><F0A78A8B><EFBFBD>
**<2A><>𠶖**嚗𡁜<E59A97><F0A1819C>刻<EFBFBD>銝箔<E98A9D>憸<EFBFBD><E686B8>銝滨泵
**排查步骤**：
**<EFBFBD>埝䰻甇仿炊**嚗?
1. 在SAE应用详情 → 环境变量中，确认所有变量已配置
1. <EFBFBD>沒AE摨𠉛鍂霂行<EFBFBD> <20>?<3F>臬<EFBFBD><E887AC>㗛<EFBFBD>銝哨<E98A9D>蝖株恕<E6A0AA><E68195><EFBFBD>匧<EFBFBD><E58CA7>誩歇<E8AAA9>滨蔭
2. <20>汾ebshell銝剜䰻<E5899C>讠㴓憓<E3B493><E68693><EFBFBD>𧶏<EFBFBD>
```bash
env | grep DATABASE_URL
env | grep JWT_SECRET
```
### 问题4：内存不足（OOM）
### <EFBFBD>桅<EFBFBD>4嚗𡁜<EFBFBD>摮䀝<EFBFBD>頞喉<EFBFBD>OOM嚗?
**症状**：应用频繁重启，日志中出现 `Out of Memory`
**<EFBFBD><EFBFBD>𠶖**嚗𡁜<E59A97><F0A1819C>券<EFBFBD>蝜<EFBFBD><E89D9C><EFBFBD>荔<EFBFBD><E88D94>亙<EFBFBD>銝剖枂<E58996>?`Out of Memory`
**解决方案**：
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
1. 在SAE应用详情 → 基本配置中，将内存调整为 **2核4GB**
1. <EFBFBD>沒AE摨𠉛鍂霂行<EFBFBD> <20>?<3F>箸𧋦<E7AEB8>滨蔭銝哨<E98A9D>撠<EFBFBD><E692A0>摮䁅<E691AE><E48185>港蛹 **2<EFBFBD>?GB**
2. <20>齿鰵<E9BDBF>函蔡摨𠉛鍂
---
@@ -360,45 +360,45 @@ curl http://172.17.173.88:3001/api/v1/users \
### 7.1 <20>亦<EFBFBD><E4BAA6>烐綉<E78390><E7B689><EFBFBD>
在SAE应用详情 → 监控中，关注以下指标：
<EFBFBD>沒AE摨𠉛鍂霂行<EFBFBD> <20>?<3F>烐綉銝哨<E98A9D><E593A8>單釣隞乩<E99A9E><E4B9A9><EFBFBD><EFBFBD>嚗?
```yaml
CPU使用率: 应 < 70%
内存使用率: 应 < 80%
实例健康状态: 应保持"健康"
请求响应时间: 应 < 1000ms
CPU雿輻鍂<EFBFBD>? 摨?< 70%
<EFBFBD><EFBFBD><EFBFBD>雿輻鍂<EFBFBD>? 摨?< 80%
摰硺<EFBFBD><EFBFBD>亙熒<EFBFBD>嗆<EFBFBD>? 摨𥪯<E691A8><F0A5AAAF>?<3F>亙熒"
霂瑟<EFBFBD><EFBFBD>滚<EFBFBD><EFBFBD>園𡢿: 摨?< 1000ms
```
### 7.2 霈曄蔭<E69B84>𡃏郎
建议配置以下告警：
撱箄悅<EFBFBD>滨蔭隞乩<EFBFBD><EFBFBD>𡃏郎嚗?
```yaml
CPU使用率 > 80%: 发送告警
内存使用率 > 90%: 发送告警
实例不健康: 立即发送告警
CPU雿輻鍂<EFBFBD>?> 80%: <EFBFBD>煾<EFBFBD><EFBFBD><EFBFBD>霅?
<EFBFBD><EFBFBD><EFBFBD>雿輻鍂<EFBFBD>?> 90%: <20>煾<EFBFBD><E785BE><EFBFBD>霅?
摰硺<EFBFBD>銝滚<EFBFBD>摨? 蝡见朖<E8A781>煾<EFBFBD><E785BE><EFBFBD>霅?
```
---
## <20><> 蝚砍<E89D9A>甇伐<E79487><E4BC90>湔鰵<E6B994>函蔡<E587BD><E894A1>﹝
部署成功后，更新以下文档：
<EFBFBD>函蔡<EFBFBD>𣂼<EFBFBD><EFBFBD>𠬍<EFBFBD><EFBFBD>湔鰵隞乩<EFBFBD><EFBFBD><EFBFBD>﹝嚗?
### 8.1 <20>湔鰵<E6B994>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD>
编辑 `00-部署进度总览.md`：
蝻𤥁<EFBFBD> `00-<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md`嚗?
```markdown
| **Node.js后端** | ✅ 已完成 | v1.0 | SAE | 2025-12-24 | ... |
| **Node.js<EFBFBD>𡒊垢** | <EFBFBD>?撌脣<E6928C><E884A3>?| v1.0 | SAE | 2025-12-24 | ... |
```
### 8.2 霈啣<E99C88><E595A3><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>
在 `00-部署进度总览.md` 中添加：
<EFBFBD>?`00-<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md` 銝剜溶<E5899C>𩤃<EFBFBD>
```markdown
| nodejs-backend-test | ✅ 运行中 | 1核2GB | 1 | 3001 | http://172.17.173.88:3001 | 无（仅内网） |
| nodejs-backend-test | <EFBFBD>?餈鞱<E9A488>銝?| 1<EFBFBD>?GB | 1 | 3001 | http://172.17.173.88:3001 | <EFBFBD>𩤃<EFBFBD>隞<EFBFBD><EFBFBD>蝵𡢅<EFBFBD> |
```
---
@@ -409,7 +409,7 @@ Node.js后端部署成功后：
### 1. <20>函蔡<E587BD>滨垢Nginx嚗<78><E59A97>銝<EFBFBD>甇伐<E79487>
前端Nginx需要配置Node.js后端的内网地址：
<EFBFBD>滨垢Nginx<EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD>蝵奘ode.js<6A>𡒊垢<F0A1928A><E59EA2><EFBFBD>蝵穃𧑐<E7A983><F0A79190>嚗?
```bash
# <20>滨垢Nginx<6E>臬<EFBFBD><E887AC>㗛<EFBFBD>
@@ -418,78 +418,79 @@ VITE_API_BASE_URL=http://172.17.173.88:3001
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>獢<EFBFBD><EFBFBD>`07-<2D>滨垢Nginx-SAE<41>函蔡<E587BD>滢<EFBFBD><E6BBA2>见<EFBFBD>.md`
### 2. 全链路测试
### 2. <EFBFBD>券曎頝舀<EFBFBD>霂?
摰峕㟲<EFBFBD><EFBFBD>窈瘙<EFBFBD>曎頝荔<EFBFBD>
```
用户浏览器
↓
<EFBFBD>冽<EFBFBD>瘚讛<EFBFBD><EFBFBD>?
<EFBFBD>?
<EFBFBD>滨垢Nginx (SAE)
↓
Node.js后端 (SAE) ← http://172.17.173.88:3001
↓
├─→ Python微服务 (SAE) ← http://172.17.173.66:8000
├─→ RDS PostgreSQL ← pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432
└─→ 阿里云OSS ← ai-clinical-research.oss-cn-beijing-internal.aliyuncs.com
<EFBFBD>?
Node.js<EFBFBD>𡒊垢 (SAE) <EFBFBD>?http://172.17.173.88:3001
<EFBFBD>?
<EFBFBD>鎿<EFBFBD><EFBFBD>?Python敺格<EFBFBD><EFBFBD>?(SAE) <EFBFBD>?http://172.17.173.66:8000
<EFBFBD>鎿<EFBFBD><EFBFBD>?RDS PostgreSQL <EFBFBD>?pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432
<EFBFBD>婙<EFBFBD><EFBFBD>?<3F>輸<EFBFBD>鈭䭲SS <EFBFBD>?ai-clinical-research.oss-cn-beijing-internal.aliyuncs.com
```
### 3. <20>扯<EFBFBD>隡睃<E99AA1>嚗<EFBFBD>虾<EFBFBD>㚁<EFBFBD>
如果测试环境运行稳定，可以考虑：
憒<EFBFBD><EFBFBD>瘚贝<EFBFBD><EFBFBD>臬<EFBFBD>餈鞱<EFBFBD>蝔喳<EFBFBD>嚗<EFBFBD>虾隞亥<EFBFBD><EFBFBD><EFBFBD>嚗?
- **弹性伸缩**：配置自动扩缩容规则
- **撘寞<EFBFBD>找撓蝻?*嚗𡁻<E59A97>蝵株䌊<E6A0AA>冽<EFBFBD>蝻拙捆閫<E68D86><E996AB>
- **韏<><E99F8F>靚<EFBFBD>㟲**嚗𡁏覔<F0A1818F>桃<EFBFBD><E6A183>扳㺭<E689B3>株<EFBFBD><E6A0AA>媒PU/<2F><><EFBFBD>
- **日志优化**：配置日志清理策略
- **<EFBFBD>亙<EFBFBD>隡睃<EFBFBD>**嚗𡁻<E59A97>蝵格𠯫敹埈<E695B9><E59F88><EFBFBD><EFBFBD><EFBFBD>?
---
## ✅ 部署完成检查清单
## <EFBFBD>?<3F>函蔡摰峕<E691B0>璉<EFBFBD><E79289>交<EFBFBD><E4BAA4>?
在完成部署后，请确认：
<EFBFBD>典<EFBFBD><EFBFBD>鞾<EFBFBD>蝵脣<EFBFBD>嚗諹窈蝖株恕嚗?
- [ ] SAE应用状态为"运行中"
- [ ] 健康检查显示"通过"
- [ ] SAE摨𠉛鍂<EFBFBD>嗆<EFBFBD><EFBFBD>蛹"餈鞱<E9A488>銝?
- [ ] <EFBFBD>亙熒璉<EFBFBD><EFBFBD>交遬蝷?<3F>朞<EFBFBD>"
- [ ] 摰墧𧒄<E5A2A7>亙<EFBFBD><E4BA99>𪊲RROR蝥批<E89DA5><E689B9>躰秤
- [ ] 健康检查接口返回200
- [ ] 内网地址已记录
- [ ] 部署文档已更新
- [ ] Python微服务可以正常调用
- [ ] 数据库连接正常
- [ ] <EFBFBD>亙熒璉<EFBFBD><EFBFBD>交𦻖<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?00
- [ ] <EFBFBD><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>撌脰扇敶?
- [ ] <EFBFBD>函蔡<EFBFBD><EFBFBD>﹝撌脫凒<EFBFBD>?
- [ ] Python敺格<EFBFBD><EFBFBD>∪虾隞交迤撣貉<EFBFBD><EFBFBD>?
- [ ] <EFBFBD>唳旿摨栞<EFBFBD><EFBFBD>交迤撣?
- [ ] OSS<53><53>辣銝𠹺<E98A9D>/銝贝蝸甇<E89DB8>虜
---
## 📞 支持与帮助
## <EFBFBD><EFBFBD> <20>舀<EFBFBD>銝𤾸葬<F0A4BEB8>?
### 撣貉<E692A3><E8B289>桅<EFBFBD>
1. **Q: 如何重启应用？**
- A: SAE应用详情 → 基本信息 → 点击【重启】
1. **Q: 憒<EFBFBD><EFBFBD><EFBFBD>滚鍳摨𠉛鍂嚗?*
- A: SAE摨𠉛鍂霂行<EFBFBD> <20>?<3F>箸𧋦靽⊥<E99DBD> <20>?<3F>孵稬<E5ADB5>鞾<EFBFBD><E99EBE>胯<EFBFBD>?
2. **Q: 如何查看完整日志？**
- A: SAE应用详情 → 日志 → 历史日志（支持时间范围查询）
2. **Q: 憒<EFBFBD><EFBFBD><EFBFBD>亦<EFBFBD>摰峕㟲<EFBFBD>亙<EFBFBD>嚗?*
- A: SAE摨𠉛鍂霂行<EFBFBD> <20>?<3F>亙<EFBFBD> <20>?<3F><>蟮<EFBFBD>亙<EFBFBD>嚗<EFBFBD>𣈲<EFBFBD><F0A388B2>𧒄<EFBFBD>渲<EFBFBD><E6B8B2>湔䰻霂ｇ<E99C82>
3. **Q: 如何回滚到之前的版本？**
- A: SAE应用详情 → 版本管理 → 选择历史版本 → 回滚
3. **Q: 憒<EFBFBD><EFBFBD><EFBFBD>墧<EFBFBD><EFBFBD>唬<EFBFBD><EFBFBD>滨<EFBFBD><EFBFBD><EFBFBD>𧋦嚗?*
- A: SAE摨𠉛鍂霂行<EFBFBD> <20>?<3F><>𧋦蝞∠<E89D9E> <20>?<3F>㗇𥋘<E39787><F0A58B98>蟮<EFBFBD><E89FAE>𧋦 <20>?<3F>墧<EFBFBD>
4. **Q: 如何扩容实例？**
- A: SAE应用详情 → 基本配置 → 修改实例数/规格 → 确认变更
4. **Q: 憒<EFBFBD><EFBFBD><EFBFBD>拙捆摰硺<EFBFBD>嚗?*
- A: SAE摨𠉛鍂霂行<EFBFBD> <20>?<3F>箸𧋦<E7AEB8>滨蔭 <20>?靽格㺿摰硺<E691B0><E7A1BA>?閫<>聢 <20>?蝖株恕<E6A0AA>䀹凒
### <20>𠉛頂<F0A0899B>孵<EFBFBD>
- **技术支持**：开发团队
- **阿里云工单**：https://workorder.console.aliyun.com/
- **<EFBFBD><EFBFBD><EFBFBD>舀𣈲<EFBFBD>?*嚗𡁜<E59A97><F0A1819C>穃𣪧<E7A983>?
- **<EFBFBD>輸<EFBFBD>鈭穃極<EFBFBD>?*嚗冴ttps://workorder.console.aliyun.com/
---
**文档创建时间**：2025-12-24
**最后更新**：2025-12-24
**维护人员**：运维团队
**<EFBFBD><EFBFBD>﹝<EFBFBD>𥕦遣<EFBFBD>園𡢿**嚗?025-12-24
**<EFBFBD><EFBFBD><EFBFBD>擧凒<EFBFBD>?*嚗?025-12-24
**蝏湔擪鈭箏<EFBFBD>**嚗朞<E59A97>蝏游𣪧<E6B8B8>?
---
🎉 **祝部署顺利！如有问题，请参考故障排查章节或联系技术支持。**
<EFBFBD><EFBFBD> **蟡嗪<E89FA1>蝵脤◇<E884A4>抬<EFBFBD>憒<EFBFBD><E68692><EFBFBD>桅<EFBFBD>嚗諹窈<E8ABB9><E7AA88><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𨀣<EFBFBD><F0A880A3>亦<EFBFBD><E4BAA6><EFBFBD><EFBFBD><EFBFBD>𠉛頂<F0A0899B><E9A082><EFBFBD>舀𣈲<E88880><F0A388B2><EFBFBD>?*