Python Bottle主app.py表单过大、@route路由杂乱如何优化

你现有代码存在几个影响稳定性和可维护性的核心问题，以下是针对性的优化方法，可直接落地：

现存核心问题 #

• 滥用全局变量跨路由传递用户行程数据：Web服务中全局变量为所有请求共享，多用户同时访问时会出现数据串号的严重bug，仅靠开发环境单用户测试无法发现
• 表单字段逐行硬编码取值，字段量增大后主文件会快速臃肿，重复代码多
• 单路由函数内混杂GET/POST分支、参数解析、业务计算、数据库操作多种职责，耦合度高，后续修改很容易牵一发动全身
• 代码缺少分层，所有逻辑堆在路由函数中，路由规模扩大后结构会完全混乱
• 现有代码缺少redirect的导入，实际运行会抛出名称错误

优化方案 #

1. 大体量表单数据处理优化 #

• 彻底移除全局变量存用户状态的逻辑：跨步骤传递的用户选择（行程时间、目的地、座位、餐食等），从上一步页面通过隐藏表单字段、URL查询参数或session传递，完全隔离不同用户的请求数据
• 统一表单字段配置：将需要提取的表单字段名定义为常量列表，通过循环统一提取、校验，避免逐行写重复的request.forms.get代码
• 通用逻辑抽离：把表单提取、参数校验的逻辑封装为独立工具函数，所有路由可复用，新增字段时只需要修改常量列表即可

2. 路由结构规范化优化 #

遵循三个原则即可让路由代码长期保持整洁：

• 按请求方法拆分路由：不要在同一个路由函数内用if request.method判断分支写逻辑，直接用Bottle自带的@get、@post装饰器拆分两个独立的处理函数，每个函数只处理一类请求
• 路由层轻量化：路由函数只保留三类逻辑：获取请求参数、调用业务逻辑（价格计算、数据库操作等）、返回响应/跳转，业务细节全部抽离到独立的函数/模块中
• 分模块管理路由：后续路由量超过10个时，用Bottle的子应用（Bottle()实例）按功能模块拆分路由文件，比如行程相关路由放trip.py，用户相关路由放user.py，主app.py只做全局配置和路由挂载，不会出现所有代码堆在一个文件的情况

优化后参考代码 #

from bottle import run, template, request, redirect, get, post
from PlanetDestination import price
from database import dataInput

# --------------------------
# 常量配置区：所有全局配置统一放在文件头部，便于修改
# --------------------------
# 乘客信息表单字段列表，后续新增字段直接往列表加即可
PASSENGER_FIELDS = ["firstName", "lastName", "birthD", "adress", "email", "phone", "payment"]
# 上一步行程选择的字段列表，通过当前表单的隐藏域传递，不再使用全局变量
TRIP_FIELDS = ["dateTime", "planet", "seat", "food"]

# --------------------------
# 工具函数区：重复使用的通用逻辑抽离，各路由可复用
# --------------------------
def extract_form(field_list):
    """统一提取并校验表单字段，返回字段值字典"""
    form_data = {}
    for field in field_list:
        val = request.forms.get(field, "").strip()
        if not val:
            # 可根据业务需求扩展自定义校验规则
            raise ValueError(f"必填字段 {field} 不能为空")
        form_data[field] = val
    return form_data

# --------------------------
# 路由区：每个路由函数职责单一，逻辑清晰
# --------------------------
@get('/information')
def render_passenger_form():
    """处理GET请求：渲染乘客信息填写页面"""
    return template('templatePersonalData')

@post('/information')
def handle_passenger_submit():
    """处理POST请求：接收提交的乘客信息，完成入库后跳转确认页"""
    # 提取参数
    passenger_data = extract_form(PASSENGER_FIELDS)
    trip_data = extract_form(TRIP_FIELDS)

    # 调用业务逻辑
    ticket_price = price(trip_data["planet"], trip_data["seat"])
    # 按数据库表字段顺序拼接入库数据
    db_record = (
        *passenger_data.values(),
        trip_data["dateTime"],
        trip_data["planet"],
        trip_data["seat"],
        trip_data["food"],
        ticket_price
    )

    # 持久化与跳转
    dataInput(db_record)
    return redirect('/confirmation')

if __name__ == "__main__":
    # 开发环境可开启debug模式，生产环境记得关闭
    run(host="localhost", port=8080, debug=True)

额外建议 #

• 代码缩进统一使用4个空格，不同逻辑块之间空一行分隔，变量、函数命名尽量语义化，基础格式规范是代码整洁的前提
• 如果后续表单字段超过15个，可以引入表单校验库统一处理字段校验、类型转换，减少重复代码
• 数据库操作、业务计算逻辑不要写在路由文件里，单独放到对应模块中，路由层只负责处理请求和响应的流转

内容的提问来源于stack exchange，提问作者ed190