Flask默认不缓存静态文件，SEND_FILE_MAX_AGE仅影响send_file()和send_from_directory等内置静态服务，且仅当设为非零整数时生效；设为0则发no-cache，设为None或负数则跳过缓存头。
Flask 默认不缓存静态文件，SEND_FILE_MAX_AGE 只影响 send_file() 和静态路由
很多人以为设了 SEND_FILE_MAX_AGE 就能自动给所有 /static/xxx.js 加缓存头，其实不是。Flask 的内置静态文件服务（app.static_folder）默认走的是 send_from_directory，它确实会读取 SEND_FILE_MAX_AGE，但仅当该配置为非零整数时才生效；设为 0 或 None 会禁用缓存头。注意：这个配置对模板中 url_for('static', filename='...') 生成的 URL 本身没影响，只控制响应头里的 Cache-Control 和 Expires。
设置 SEND_FILE_MAX_AGE 的正确方式和常见错误
直接在创建 Flask 实例后赋值即可，但必须是整数秒（单位是秒，不是毫秒或字符串）：
app = Flask(__name__) app.config['SEND_FILE_MAX_AGE'] = 31536000 # 1年，推荐用于带哈希的静态文件
- 设成
0：响应头会带Cache-Control: no-cache，浏览器每次都会发条件请求（If-None-Match），适合开发调试 - 设成负数或
None：Flask 会跳过缓存头设置，响应里没有Cache-Control，行为由 Web 服务器（如 Nginx）接管或退化为无缓存 - 设成正整数但太小（比如
60）：可能导致浏览器频繁重验证，反而增加请求数，不适合 CSS/JS 等稳定资源
带哈希的文件才适合长期缓存，否则要手动刷新 CDN 或用户缓存
如果你的 main.css 没改名就直接设 SEND_FILE_MAX_AGE = 31536000，用户更新代码后可能还在用旧缓存。真正安全的做法是：
- 构建时生成带内容哈希的文件名，比如
main.a1b2c3d4.css - 模板里用
url_for('static', filename='main.a1b2c3d4.css')，确保 URL 变化即缓存失效 - 此时才能放心设高龄缓存，否则得靠版本参数（
?v=1.2.3）——但 Flask 静态视图默认忽略查询参数，不会触发新缓存
如果不用构建工具，临时方案是重写 static 视图，手动提取 v 参数并传给 send_from_directory，但这绕过了 SEND_FILE_MAX_AGE 的自动逻辑，需自行加 make_response 并设头。
立即学习“Python免费学习笔记（深入）”；
Nginx / Gunicorn 前置时，SEND_FILE_MAX_AGE 可能被覆盖
生产环境通常用 Nginx 代理 Flask，这时要注意：
- Nginx 默认不转发 Flask 返回的
Cache-Control，除非你显式配置proxy_pass_request_headers on; - 更常见的是，Nginx 自己对
/static/路径做了location拦截，直接由 Nginx 服务静态文件——此时 Flask 根本不参与，SEND_FILE_MAX_AGE完全无效 - 验证是否被 Nginx 接管：curl -I http://yoursite/static/test.js，看
Server头是不是nginx，以及Cache-Control是不是来自 Nginx 配置
真要用 Flask 控制缓存，就得关掉 Nginx 的静态文件服务，把所有 /static/ 请求透传给 Flask，或者干脆放弃 SEND_FILE_MAX_AGE，统一在 Nginx 里配 expires 指令。
