xiaoxia/xiaoxia-saas

Fork 0

Files

T

xiaoxia a6e85092ce fix: 统一 ENABLE_REDIS_SESSIONS 命名，修复登录因 AttributeError 导致 500

2026-06-27 17:05:48 +08:00

5.7 KiB

Raw Permalink Blame History

小虾 SaaS 启动成功报告

启动时间：2026-06-20 10:13 GMT+8
状态：✅ 全部服务运行正常

一、服务状态

✅ API 服务（后端）

地址：http://localhost:8000
API 文档：http://localhost:8000/docs
健康检查：http://localhost:8000/health
状态：✅ 运行正常
进程 ID：23064

验证结果：

{
  "status": "healthy",
  "timestamp": "2026-06-20T02:12:25.998808",
  "version": "0.1.0"
}

✅ 前端服务（React + Vite）

地址：http://localhost:3001
状态：✅ 运行正常
启动时间：5036ms
Node 进程：19180, 23916

说明：原计划端口 3000 被占用，Vite 自动切换到 3001

✅ Worker 服务（Celery）

状态：✅ 运行正常
连接：Redis (47.98.113.167:6379)
任务队列：准备就绪

二、基础设施（服务器）

✅ PostgreSQL 16

地址：47.98.113.167:5432
数据库：xiaoxia_saas
用户：xiaoxia
状态：✅ 运行中
表：6 张核心表已创建

✅ Redis 7

地址：47.98.113.167:6379
状态：✅ 运行中
用途：缓存 + Celery 任务队列

✅ MinIO

API：47.98.113.167:9000
控制台：http://47.98.113.167:9001
Bucket：xiaoxia-saas
状态：✅ 运行中

三、启动过程中修复的问题

问题 1：PYTHONPATH 未设置

现象：API 无法导入 packages 模块

解决：在启动脚本中设置 $env:PYTHONPATH = "F:\openclaw-saas"

问题 2：缺少 psycopg2-binary

现象：ModuleNotFoundError: No module named 'psycopg2'

解决：pip install psycopg2-binary

问题 3：导入路径错误

现象：cannot import name 'Task' from 'packages.domain.entities'

解决：修改导入为 from packages.domain.project_management import Task

问题 4：APIRouter 循环引用

现象：Cannot include the same APIRouter instance into itself

解决：删除错误的 health_router.include_router(health_router := health_router) 语句

四、访问指南

🌐 前端界面

访问地址：http://localhost:3001

功能清单：

✅ 用户注册/登录
✅ 工作空间管理
✅ 项目管理
✅ 素材上传
✅ 素材分类
✅ 视频生成
✅ 结果下载

📚 API 文档

访问地址：http://localhost:8000/docs

包含的 API：

认证 API
工作空间 API
项目 API
素材 API
生成任务 API
上传 API

五、启动脚本

已创建 3 个启动脚本：

F:\openclaw-saas\start-api.ps1 - 启动 API 服务
F:\openclaw-saas\start-web.ps1 - 启动前端服务
F:\openclaw-saas\start-worker.ps1 - 启动 Worker 服务

下次启动：

# 方式 1：手动启动 3 个窗口
Start-Process powershell -ArgumentList "-NoExit", "-Command", "& 'F:\openclaw-saas\start-api.ps1'"
Start-Process powershell -ArgumentList "-NoExit", "-Command", "& 'F:\openclaw-saas\start-web.ps1'"
Start-Process powershell -ArgumentList "-NoExit", "-Command", "& 'F:\openclaw-saas\start-worker.ps1'"

# 方式 2：直接在 3 个终端窗口运行
# 终端 1: .\start-api.ps1
# 终端 2: .\start-web.ps1
# 终端 3: .\start-worker.ps1

六、验收测试清单

基础功能验证

访问首页 (http://localhost:3001)
用户注册
用户登录
创建工作空间
创建项目
查看项目列表

核心功能验证（需要素材文件）

上传视频素材
触发素材分类
创建生成任务
查看生成结果
下载生成的视频

七、已知限制

前端端口变更
- 原计划：3000
- 实际使用：3001
- 原因：端口 3000 被其他服务占用
服务器基础设施
- 使用服务器上的 PostgreSQL/Redis/MinIO
- 本地无法离线运行
- 需要保持与服务器的网络连接

八、下一步

立即可做

基础功能验证（5 分钟）
- 注册账号
- 登录系统
- 创建工作空间和项目
核心功能验证（10 分钟）
- 准备几个短视频文件（MP4）
- 上传到系统
- 触发视频生成
- 查看和下载结果

后续优化（非紧急）

本地基础设施
- 安装本地 PostgreSQL/Redis/MinIO
- 支持离线开发
端口配置
- 修改前端默认端口为 5173
- 或释放端口 3000
性能优化
- Worker 并发数调优
- 视频处理速度优化

九、故障排查

如果服务无法访问

检查服务状态：

# 检查端口监听
netstat -ano | findstr ":8000"  # API
netstat -ano | findstr ":3001"  # 前端

# 检查进程
Get-Process python | Where-Object {$_.StartTime -gt (Get-Date).AddHours(-1)}
Get-Process node | Where-Object {$_.StartTime -gt (Get-Date).AddHours(-1)}

重启服务：

# 停止所有服务
Get-Process python | Stop-Process -Force
Get-Process node | Stop-Process -Force

# 重新启动
.\start-api.ps1
.\start-web.ps1
.\start-worker.ps1

如果数据库连接失败

检查服务器服务：

ssh xiaoxia-server "docker ps"

重启服务器服务：

ssh xiaoxia-server "docker restart xiaoxia-postgres xiaoxia-redis xiaoxia-minio"

十、总结

✅ 启动成功！

所有服务运行正常：

API 服务 ✅
前端服务 ✅
Worker 服务 ✅
基础设施 ✅

现在可以开始验证小虾 SaaS 的完整功能了！

报告人：小虾 🦐
完成时间：2026-06-20 10:13 GMT+8
状态：✅ 就绪验收

5.7 KiB Raw Permalink Blame History Unescape Escape