cavin/full-stack-doc

Fork 0

Files

peng 6e4e48fdd2 初次提交

2025-10-14 20:05:29 +08:00

3.2 KiB

Raw Blame History

云盘应用端口8080启动和测试指南

🚀 快速启动

方法1：自动启动并测试（推荐）

cd backend
chmod +x start_and_test_8080.sh
./start_and_test_8080.sh

方法2：手动启动

cd backend

# 1. 启动服务器
python3 start_8080.py

# 2. 在另一个终端测试API
python3 test_api_8080.py

方法3：自动模式

cd backend
python3 start_8080.py --auto

📋 测试的API端点

基础端点

GET / - 根路径
GET /health - 健康检查
GET /api/v1/health - API健康检查
GET /docs - Swagger API文档
GET /redoc - ReDoc文档
GET /openapi.json - OpenAPI规范

认证端点

POST /api/v1/auth/register - 用户注册
POST /api/v1/auth/token - 用户登录

文件端点

GET /api/v1/files - 文件列表
POST /api/v1/files/upload - 文件上传

🔧 环境要求

Python 3.8+
依赖包：见 requirements_8080.txt

📦 安装依赖

cd backend
pip install -r requirements_8080.txt

🌐 访问地址

启动成功后，可以通过以下地址访问：

本地访问: http://localhost:8080
API文档: http://localhost:8080/docs
健康检查: http://localhost:8080/api/v1/health

🧪 测试命令

测试所有端点

python3 test_api_8080.py

测试特定端点类型

# 只测试基础端点
python3 test_api_8080.py --basic

# 只测试认证端点
python3 test_api_8080.py --auth

# 只测试文件端点
python3 test_api_8080.py --files

指定不同的API地址

python3 test_api_8080.py --url http://192.168.1.100:8080

启动前等待时间

python3 test_api_8080.py --wait 5  # 等待5秒后开始测试

📊 测试结果说明

✅ 成功: 端点正常响应
🔌 连接失败: 无法连接到服务器
⏰ 超时: 请求超时
❌ 其他错误: 各种错误情况

🔍 故障排除

端口被占用

# 查看占用端口的进程
lsof -i :8080

# 停止进程
kill -9 <PID>

依赖问题

# 安装基础依赖
pip install fastapi uvicorn requests

# 或安装所有依赖
pip install -r requirements_8080.txt

模块导入错误

如果遇到模块导入错误，脚本会自动切换到简化模式，提供基础的API功能。

🎯 预期结果

正常运行时，你应该看到：

服务器启动信息

🚀 启动云盘应用服务...
📍 本地访问:
   根路径: http://localhost:8080
   API文档: http://localhost:8080/docs

API测试结果

🧪 开始API测试 - 端口8080
📊 测试报告
总测试数: 6
成功: 6
失败: 0
成功率: 100.0%
🎉 所有测试通过！API服务运行正常

API响应示例

{
  "message": "云盘应用 API",
  "version": "1.0.1",
  "docs": "/docs",
  "health": "/api/v1/health"
}

📞 使用curl测试

你也可以使用curl命令直接测试：

# 测试根路径
curl http://localhost:8080/

# 测试健康检查
curl http://localhost:8080/api/v1/health

# 测试API文档
curl -I http://localhost:8080/docs

现在你可以选择任何一种方式启动和测试你的云盘应用在端口8080上！

3.2 KiB Raw Blame History Unescape Escape