FastAPI + gRPC 全栈实践：Windows 开发到 Ubuntu 部署全指南

技术博客标题：

《FastAPI + gRPC 全栈实践：Windows 开发到 Ubuntu 部署全指南》

---

环境搭建与开发流程

一、Windows 11 开发环境搭建

1. 安装 Python 3.9+

   • 官网下载安装包：Python Downloads
   • 勾选 Add Python to PATH

2. 创建虚拟环境

   python -m venv fastenv
   fastenv\Scripts\activate
   

3. 安装依赖

   pip install fastapi uvicorn[standard] grpcio grpcio-tools protobuf requests
   

---

二、项目结构

FASTAPI_GRPC_DEMO/
├── server/                  # 服务端代码
│   ├── main.py              # FastAPI 主入口
│   ├── grpc_server.py       # gRPC 服务实现
│   └── protos/              # Proto 文件目录
│       └── demo.proto
├── client/                  # 客户端代码
│   ├── rest_client.py       # REST 测试客户端
│   └── grpc_client.py       # gRPC 测试客户端
└── generated/               # 自动生成的 gRPC 代码

---

三、服务端开发

1. 定义 gRPC Proto 文件 (server/protos/demo.proto)

syntax = "proto3";

package demo;

service DemoService {
  rpc GetMessage (Request) returns (Response) {}
}

message Request {
  string name = 1;
}

message Response {
  string message = 1;
}

2. 生成 gRPC 代码

python -m grpc_tools.protoc -I server/protos/ \
  --python_out=generated \
  --grpc_python_out=generated \
  server/protos/demo.proto

3. 实现 gRPC 服务 (server/grpc_server.py)

from concurrent import futures
import grpc
from generated import demo_pb2, demo_pb2_grpc

class DemoService(demo_pb2_grpc.DemoServiceServicer):
    def GetMessage(self, request, context