异常教程

Flask 路由（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 Web 开发领域，Flask 路由是连接客户端请求与服务器端逻辑的核心桥梁。对于初学者而言，理解路由机制如同掌握一座城市的交通规则：只有明确每条路径的指向，才能让应用程序高效响应用户需求。而中级开发者则需要通过路由实现更复杂的业务场景，例如动态页面生成或 API 接口设计。本文将从基础概念出发，结合实际案例和代码示例，逐步解析Flask 路由的实现逻辑与进阶技巧，帮助读者构建清晰的路由系统思维框架。

Flask 路由的基础概念

路由的核心作用

Flask 路由的本质是“映射关系”的建立——将客户端的 URL 请求与服务器端的 Python 函数（视图函数）进行绑定。例如，当用户访问 /hello 时，Flask 会自动调用与该路径关联的函数，并返回相应的网页内容或数据。

简单路由示例

from flask import Flask
app = Flask(__name__)

@app.route('/')
def home():
    return '欢迎来到首页！'

if __name__ == '__main__':
    app.run()

在这个代码片段中：

  1. @app.route('/') 是装饰器，将 / 路径与 home() 函数绑定；
  2. 当用户访问根路径时，home() 函数会返回字符串“欢迎来到首页！”作为响应。

装饰器：Flask 路由的“交通指挥官”

装饰器（Decorator）是 Python 的高级特性之一，而 @app.route() 正是 Flask 路由的核心工具。可以将其想象为“交通指挥官”：它负责识别 URL 路径，然后将请求“指挥”到对应的函数中处理。

装饰器的灵活性

一个函数可以同时绑定多个路由路径：

@app.route('/about')
@app.route('/contact')
def info_page():
    return '这里是关于页面或联系方式'

此时，访问 /about 或 /contact 都会触发 info_page() 函数。这种设计减少了代码冗余，体现了装饰器的复用性。

动态路由与参数传递

动态路由：让 URL 变得“智能”

静态路由（如 /home）只能处理固定路径，而动态路由通过占位符（如 <variable>）实现 URL 的灵活匹配。例如，博客系统中的文章详情页路径 /post/<post_id>，其中 <post_id> 可以是任意数字或字符串。

动态参数示例

@app.route('/user/<username>')
def profile(username):
    return f'欢迎用户：{username}'

当用户访问 /user/张三 时，username 参数的值为“张三”，函数会返回个性化欢迎信息。

变量规则：定义参数的“身份”

Flask 允许通过 <variable_name:type> 为动态参数指定类型限制，常见的类型包括：

  • int：接受整数（如 /product/123）；
  • float：接受浮点数（如 /api/v1.0/data）；
  • path：接受包含斜杠的路径（如 /files/report/2023）。

类型约束代码示例

@app.route('/blog/<int:post_id>')
def show_post(post_id):
    if post_id == 1:
        return '这是第一篇博客'
    else:
        return '未找到该文章'

此时，访问 /blog/abc 会引发 404 错误，因为 abc 不是整数类型。

路径中的可选参数与默认值

通过 defaults 参数，可以设置动态路由的默认值，例如：

@app.route('/search', defaults={'page': 1})
@app.route('/search/page/<int:page>')
def search(page):
    return f'显示第 {page} 页搜索结果'

此时：

  • 访问 /search 会默认显示第 1 页；
  • 访问 /search/page/3 则显示第 3 页。

路由的高级用法

重定向：URL 的“智能跳转”

通过 redirect() 函数，可以实现 URL 的动态重定向。例如，将 /old-path 重定向到 /new-path：

from flask import redirect, url_for

@app.route('/old-path')
def old_route():
    return redirect(url_for('new_route'))

@app.route('/new-path')
def new_route():
    return '这是新路径'

url_for() 函数根据视图函数名称生成 URL，避免了硬编码路径的风险。

自定义错误页面：优雅的异常处理

通过 errorhandler() 装饰器，可以为不同 HTTP 状态码（如 404、500）定制响应内容：

@app.errorhandler(404)
def page_not_found(e):
    return '请求的页面不存在！', 404

当用户访问不存在的路径时，将返回自定义的 404 错误页面。

路由的“隐藏”技巧

方法限定：区分 HTTP 请求类型

通过 methods 参数，可以指定路由支持的 HTTP 方法（如 GET、POST）：

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        # 处理表单提交
        return '登录成功'
    else:
        # 渲染登录表单
        return '这是登录页面'

若未指定方法，默认仅支持 GET 请求。

路由优先级：路径匹配的“优先法则”

当多个路由路径存在重叠时，Flask 按照路由定义的顺序和匹配规则进行选择。例如：

@app.route('/user/<name>')
def user(name):
    return f'用户页面：{name}'

@app.route('/user/admin')
def admin():
    return '管理员后台'

此时，访问 /user/admin 会触发 admin()，而非 user()，因为更具体的路径优先级更高。

实战案例：构建简易博客系统

需求分析

创建一个包含以下功能的博客应用：

  1. 首页显示所有文章标题；
  2. 文章详情页通过动态路由访问（如 /post/1）；
  3. 404 错误页面；
  4. 表单提交的登录页面。

完整代码示例

from flask import Flask, redirect, url_for, request

app = Flask(__name__)

posts = [
    {'id': 1, 'title': 'Flask 路由详解'},
    {'id': 2, 'title': 'Python 装饰器入门'},
]

@app.route('/')
def home():
    return '<br>'.join([f'<a href="{url_for("post", post_id=post["id"])}">{post["title"]}</a>' for post in posts])

@app.route('/post/<int:post_id>')
def post(post_id):
    post = next((item for item in posts if item['id'] == post_id), None)
    if post:
        return f'文章标题：{post["title"]}'
    else:
        return redirect(url_for('page_not_found'))

@app.errorhandler(404)
def page_not_found(e):
    return '404 - 页面未找到', 404

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        username = request.form.get('username')
        if username:
            return f'欢迎 {username} 登录！'
        else:
            return '用户名不能为空'
    else:
        return '''<form method="post">
                    用户名：<input type="text" name="username">
                    <input type="submit" value="登录">
                  </form>'''

运行效果

  1. 访问 / 可看到所有文章链接；
  2. 点击链接跳转到具体文章页（如 /post/1）；
  3. 输入无效文章 ID 会触发 404 页面；
  4. 登录页面支持表单提交和方法区分。

结论

通过本文的讲解，读者可以掌握Flask 路由从基础到进阶的实现方法，包括装饰器的使用、动态参数的设计、HTTP 方法的限制以及错误处理的优雅方案。在实际开发中，合理规划路由结构能显著提升代码的可维护性和扩展性。建议读者通过构建小型项目（如待办事项列表或个人博客）进一步巩固知识，并探索 Flask-RESTful 等扩展库的高级功能。记住，路由不仅是技术实现，更是用户与系统交互的“导航图”——唯有设计清晰，才能让应用程序真正“活”起来。

最新发布

查看更多文章