README_zh-CN.md

Python 云函数 - FastAPI | EdgeOne Pages

演示网站，展示如何在 EdgeOne Pages 上将高性能 FastAPI 应用部署为无服务器函数。

🚀 特性

• FastAPI 框架：现代、快速（高性能）的 API 构建框架
• 自动 OpenAPI：自动生成 Swagger UI 和 ReDoc 文档
• Pydantic 验证：使用类型提示自动验证请求/响应
• 异步支持：原生 async/await 实现高性能
• 类型安全：完整的 Python 类型提示支持

🛠️ 技术栈

前端

• Next.js 15 - React 全栈框架
• React 19 - 用户界面库
• TypeScript - 类型安全的 JavaScript
• Tailwind CSS 4 - 实用优先的 CSS 框架

后端

• FastAPI - 现代 Python Web 框架
• Pydantic - 使用 Python 类型提示进行数据验证
• Cloud Functions - EdgeOne Pages 无服务器函数

📁 项目结构

python-fastapi-template/
├── src/                    # Next.js 前端
├── cloud-functions/        # Python 云函数
│   ├── api/
│   │   └── [[default]].py # FastAPI 应用
│   └── requirements.txt   # Python 依赖
├── public/                # 静态资源
└── package.json          # 项目配置

🚀 快速开始

环境要求

• Node.js 18+
• Python 3.9+
• EdgeOne CLI

安装依赖

npm install

开发模式

edgeone pages dev

访问 http://localhost:8088 查看应用。

🎯 API 端点

方法	路径	描述
GET	/api/	根端点
GET	/api/health	健康检查
GET	/api/info	函数信息
GET	/api/time	当前服务器时间
GET/POST	/api/echo	回显请求信息
POST	/api/json	处理 JSON 请求体
GET	/api/users/{user_id}	根据 ID 获取用户
POST	/api/users	创建新用户
GET	/api/search	带查询参数搜索
GET	/api/docs	Swagger UI 文档
GET	/api/redoc	ReDoc 文档

📚 文档入口

• FastAPI 文档：https://fastapi.tiangolo.com
• EdgeOne Pages 文档：https://pages.edgeone.ai/document/python

部署

📄 许可证

本项目采用 MIT 许可证。