毕业设计网络方向入门实战：从零搭建一个高可用的简易Web服务-编程阁

背景痛点：为什么网络方向的毕设总被“环境”卡住

做网络编程的毕业设计，最怕的不是写不出代码，而是“跑不起来”。我去年带学弟做答辩旁听，十组里至少四组在现场演示时翻车：

本机跑得好好的，一换实验室电脑就 404
端口被占用，临时改配置，PPT 里截图和现场对不上
把数据库账号密码写死在代码里，GitHub 一公开，老师直接问“如果这是公司项目，你明天就被开除”
只实现功能，没日志、没异常处理，一报错就“白屏”，评审只能看代码猜意图

归根结底，是“课程作业思维”还没切换到“小工程思维”。课程作业只关注算法对错，毕设却要求“可运行、可演示、可扩展”。先把工程骨架搭稳，再填功能，才能避免现场社死。

技术选型：Flask、FastAPI、Django 怎么挑

Python 生态里这三位最常用，但毕设场景下各有取舍：

框架	上手曲线	自带功能	异步支持	模板引擎	备注
Flask	最平缓	最少	无	Jinja2	插件多，但得自己拼
FastAPI	中等	依赖注入+数据验证+自动生成 OpenAPI	原生 async	无	类型提示友好，文档自动生成，答辩加分
Django	最陡峭	全家桶（ORM、后台、权限）	3.1+ 部分支持	自带	重，写论文时“亮点”常被框架掩盖

结论：

如果你想“一周出 demo”，而且答辩老师喜欢问“接口文档在哪”，FastAPI 是最省心的折中。
本文余下部分就基于 FastAPI 展开，但思路同样适用于 Flask。

核心实现：一个带登录的 RESTful 服务

功能范围刻意收敛，只做“用户注册+JWT 登录+查询个人信息”，保证能在 5 分钟内跑通，又覆盖“网络方向”最关注的 HTTP 语义、状态码、认证、数据验证。

1. 项目骨架

miniweb/ ├── app/ │ ├── __init__.py │ ├── main.py │ ├── deps.py │ ├── models.py │ └── routers/ │ ├── __init__.py │ └── users.py ├── requirements.txt ├── Dockerfile └── nginx.conf

2. 依赖文件

requirements.txt

fastapi==0.110.0 uvicorn[standard]==0.27.0 passlib[bcrypt]==1.7.4 python-jose[cryptography]==3.3.0 python-multipart==0.0.9

3. 数据模型与业务逻辑

app/models.py

from pydantic import BaseModel, EmailStr, Field class UserReg(BaseModel): email: EmailStr password: str = Field(..., min_length=6) class UserOut(BaseModel): id: int email: EmailStr

app/deps.py

from datetime import datetime, timedelta from jose import jwt, JWTError from fastapi import HTTPException, status, Depends from fastapi.security import OAuth2PasswordBearer SECRET = "CHANGE_ME_IN_PRODUCTION" # 生产环境用环境变量注入 ALGORITHM = "HS256" oauth2 = OAuth2PasswordBearer(tokenUrl="/users/login") def create_token(data: dict, expire_minutes: int = 30) -> str: to_encode = data.copy() expire = datetime.utcnow() + timedelta(minutes=expire_minutes) to_encode.update({"exp": expire}) return jwt.encode(to_encode, SECRET, algorithm=ALGORITHM) def get_current_user(token: str = Depends(oauth2)) -> str: try: payload = jwt.decode(token, SECRET, algorithms=[ALGORITHM]) email: str = payload.get("sub") if email is None: raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Invalid token") return email except JWTError: raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Token decode failed")

4. 路由层

app/routers/users.py

from fastapi import APIRouter, HTTPException, status from passlib.hash import bcrypt from app.models import UserReg, UserOut from app.deps import create_token, get_current_user router = APIRouter(prefix="/users", tags=["users"]) fake_db: dict[str, dict] = {} # 演示用内存库，毕设可换成 SQLite @router.post("/register", response_model=UserOut, status_code=201) def register(form: UserReg): if form.email in fake_db: raise HTTPException(409, "Email already exists") hashed = bcrypt.hash(form.password) fake_db[form.email] = {"id": len(fake_db) + 1, "email": form.email, "hash": hashed} return UserOut(id=fake_db[form.email]["id"], email=form.email) @router.post("/login") def login(form: UserReg): user = fake_db.get(form.email) if not user or not bcrypt.verify(form.password, user["hash"]): raise HTTPException(401, "Wrong email or password") token = create_token({"sub": form.email}) return {"access_token": token, "token_type": "bearer"} @router.get("/me", response_model=UserOut) def me(email: str = Depends(get_current_user)): user = fake_db[email] return UserOut(id=user["id"], email=user["email"])

5. 入口文件

app/main.py

from fastapi import FastAPI from fastapi.middleware.cors import CORSMiddleware from app.routers import users app = FastAPI(title="MiniWeb", version="1.0.0") app.add_middleware( CORSMiddleware, allow_origins=["*"], # 生产环境改成前端域名 allow_credentials=True, allow_methods=["*"], allow_headers=["*"], ) app.include_router(users.router) @app.get("/") def root(): return {"message": "Hello network world"}

6. 本地运行

uvicorn app.main:app --reload

浏览器打开 http://127.0.0.1:8000/docs 就能看到自动生成的 Swagger，注册、登录、拿个人信息一条龙。

部署方案：Docker + Nginx 反向代理

1. 容器化

Dockerfile

FROM python:3.11-slim WORKDIR /app COPY requirements.txt . RUN pip install -r requirements.txt COPY app ./app CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

构建并启动

docker build -t miniweb . docker run -d --name api -p 8000:8000 miniweb

2. Nginx 反向代理

nginx.conf（核心片段）

server { listen 80; server_name your.domain or IP; location / { proxy_pass http://api:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

用官方 nginx 镜像一起编排：

docker-compose.yml

version: "3.9" services: api: build: . nginx: image: nginx:alpine ports: - "80:80" volumes: - ./nginx.conf:/etc/nginx/conf.d/default.conf depends_on: - api

一键docker-compose up -d，80 端口即对外服务，后续换 HTTPS 只需改 Nginx 配置，无需动代码。

安全性与性能：别让“小项目”成为“大漏洞”

CORS：前端调试阶段常allow_origins=["*"]，答辩前一定改成确切域名，否则老师一句“任意站点都能调你接口”就扣分。
速率限制：安装slowapi或fastapi-limiter，给注册/登录接口加每分钟 5 次限制，演示时刷新页面就不会被刷爆。
SQL 注入：本文用内存字典，真实毕设换 ORM（SQLAlchemy/Tortoise）时记得用绑定参数，ORM 已默认防注入，不要自己拼接 SQL。
密钥管理：把SECRET、数据库地址放到环境变量，Docker 启动时-e SECRET=xxx，代码里os.getenv读取，硬编码=0 分。
日志：uvicorn 加--log-config logging.yaml，至少记录 4xx/5xx，答辩现场出错能定位，老师看你专业。

生产环境避坑指南

端口冲突：提前在服务器netstat -tunlp查 80/443 是否被占用，别等到演示前一分钟才kill进程。
热更新：演示当天别拉最新依赖，提前一周锁定版本，requirements.txt 带具体版本号。
异常兜底：FastAPI 默认会堆栈暴露，生产环境加app.add_exception_handler(Exception, handler)返回统一 JSON，防止泄露路径。
数据持久化：SQLite 文件挂宿主机卷-v $(pwd)/data:/app/data，容器重建数据不丢。
备份脚本：每晚tar打包 SQLite + 上传对象存储，老师一看“还有灾备”，印象分++。