翻完flask 3.1.0的官方更新日志可以确认，这个版本2024年11月13日正式发布，是3.1系列的首个基础版本。官方列出的更新内容包括：停止支持python 3.8、上调最低依赖版本、新增控制自动options响应的配置、给资源打开方法增加encoding参数、引入请求资源限制配置、支持partitioned cookie、支持密钥轮换、调整server_name相关行为，还新增了trusted_hosts配置。对项目维护者来说，3.1.0这次更新明显更偏向部署优化、安全增强和框架基础能力升级。

来源：Flask 官方文档

升级时第一个要确认的前提，就是Python 3.8已经不在支持范围内。很多企业项目会把Flask版本和运行时镜像绑定，如果基础镜像里的Python还是旧版本，直接升3.1系列一上来就会碰到运行环境报错。与此同时，Werkzeug、ItsDangerous和Blinker的最低要求版本也全部上调，这意味着你得把整个Pallets生态的依赖放在一起整体评估，不能只单独升级Flask这一个包。

3.1.0剩下的改动大多面向生产环境的细节优化。比如TRUSTED_HOSTS可以在路由阶段校验可信主机，SESSION_COOKIE_PARTITIONED支持Partitioned Cookie，Request.max_content_length可以针对不同请求自定义限制。这些能力不会默认改动所有现有项目的运行逻辑，但给维护者提供了更贴近框架底层的控制点，完全可以搭配反向代理规则、浏览器Cookie策略和上传限制规则一起配置。

来源：Flask 官方 Quickstart 文档

实际动手升级的时候，建议先确认Python版本和所有依赖的最低要求都达标，再检查现有应用有没有依赖旧版的SERVER_NAME限制逻辑、旧的表单上传限制方式、旧session签名策略或者默认的自动OPTIONS响应逻辑。Flask 3.1.0不只是面向新项目的版本，老项目也可以借着这次升级，把之前散落在外部脚本里的安全、部署边界配置统一收回到框架原生配置里，前提是你的项目测试覆盖足够完整，不会踩隐性坑。

GitHub Hosts CN

GitHub Hosts 更新工具（仅限中国用户），安全更新系统hosts文件，保留原有非GitHub条目，仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。

下载

信源说明：本文依据Flask 3.1.0官方更新日志页面、Flask官方文档首页和Quickstart文档撰写；实际升级的适配边界请以自身项目运行环境、依赖版本和官方最新说明为准。