application_root必须显式设置为带首尾斜杠的子路径（如/myapp/），且需在创建flask实例后、注册蓝图前配置，否则路由匹配失败、url_for生成错误链接、静态文件404；还需配合static_url_path和nginx的script_name透传。
APPLICATION_ROOT 配置必须显式设置，否则子路径下所有路由 404
Flask 默认把应用当作部署在根路径 / 下运行。如果你把 Flask 应用部署在 Nginx 或 Apache 的子路径（比如 /myapp/），但没设 APPLICATION_ROOT，那么 url_for() 生成的链接全是错的，静态文件 404，重定向跳转也指向根路径——根本不是你部署的位置。
关键点在于：APPLICATION_ROOT 不只是影响 url_for()，它还会告诉 Werkzeug 路由系统：“请从这个前缀之后开始匹配”。否则，Werkzeug 会把整个请求路径（如 /myapp/login）直接拿去匹配 @app.route('/login')，而因为开头多了 /myapp，根本对不上。
-
APPLICATION_ROOT必须以/开头、结尾，例如/myapp/；写成myapp或/myapp（缺末尾斜杠）都会导致部分匹配失败 - 必须在创建
Flask实例后、注册任何蓝图前设置，否则蓝图里的url_prefix会和它叠加出意料之外的路径 - 如果用了反向代理（如 Nginx），还需配合
SCRIPT_NAME环境变量或中间件，仅靠APPLICATION_ROOT不够
子路径 + 蓝图 url_prefix 容易嵌套重复，要手动对齐层级
常见错误是：APPLICATION_ROOT = '/myapp/'，同时又给蓝图设了 url_prefix='/myapp/api'。结果 url_for('api.get_users') 生成 /myapp/myapp/api/users，多了一层。
正确做法是让蓝图只管“内部路径”，把部署前缀交给 APPLICATION_ROOT 统一处理：
- 主配置设
app.config['APPLICATION_ROOT'] = '/myapp/' - 蓝图定义时，
url_prefix写相对路径，比如url_prefix='/api'或url_prefix='/admin' - 最终访问地址就是
/myapp/api/users，干净且可预测
验证方式：启动后执行 flask routes，看 Rule 列是否已自动带上 /myapp/ 前缀。如果没有，说明 APPLICATION_ROOT 没生效或设置太晚。
静态文件路径错乱？检查 static_url_path 和 static_folder
即使 APPLICATION_ROOT 设置正确，静态资源仍可能 404——因为 Flask 默认从 /static/ 加载，而你的 Nginx 实际把 /myapp/static/ 映射到了磁盘目录。
解决方法是显式声明静态资源的公开 URL 前缀：
- 设
static_url_path='/myapp/static'（注意和APPLICATION_ROOT一致） - 保持
static_folder指向真实磁盘路径，如'./static'，不要加部署前缀 - 如果用了蓝图，蓝图内引用静态文件也要用
url_for('static', filename='...')，不能硬编码/static/xxx
漏掉 static_url_path 是最常被忽略的环节。很多开发者只改了 APPLICATION_ROOT，却忘了静态资源走的是另一套路径逻辑。
Nginx 反向代理时，SCRIPT_NAME 和 X-Script-Name 头必须传入
Flask 在 WSGI 环境中依赖 SCRIPT_NAME 环境变量来识别部署子路径。如果你用 Nginx 反向代理到 /myapp/，但没透传这个变量，APPLICATION_ROOT 就形同虚设。
Nginx 配置关键段必须包含：
location /myapp/ {
proxy_pass http://127.0.0.1:5000/;
proxy_set_header SCRIPT_NAME /myapp;
proxy_set_header X-Script-Name /myapp;
}
注意：proxy_pass 末尾的 / 很重要，它会让 Nginx 剥掉 /myapp 再转发，否则 Flask 收到的路径还是带前缀的，造成双重匹配。
没有这一步，哪怕代码里所有配置都对，请求进来的路径还是原始的 /myapp/login，Werkzeug 匹配时找不到对应规则——因为它的匹配起点已经被 SCRIPT_NAME 错误地设为了空字符串。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
