Flask全局设置static_folder路径：多层级路由下静态资源路径异常

你遇到的这个问题其实很常见，核心原因不是static_folder的配置问题，而是浏览器对相对路径的解析逻辑：当你访问多层级URL（比如localhost:5000/home/whatever）时，浏览器会把当前URL的路径（/home/whatever）当作相对路径的基准，所以请求静态资源时会自动拼接成/home/static/...，而不是你期望的根路径/static/...。

下面给你几个靠谱的解决方案，按推荐程度排序：

1. 用Flask的url_for生成静态资源URL（最稳妥） #

在你的index.html模板里，不要直接写相对路径，而是用Flask提供的url_for函数来生成静态资源的绝对路径。比如：

<script src="{{ url_for('static', filename='someJavascript.js') }}"></script>

这样不管当前路由是单层级还是多层级，Flask都会自动生成正确的根路径静态资源URL，完全避免路径解析问题。

2. 给静态资源URL设置固定前缀 #

初始化Flask应用时，加上static_url_path参数，强制指定静态资源的URL前缀为根路径的/static：

app = Flask(__name__, 
            static_folder="../static/dist", 
            template_folder="../static",
            static_url_path="/static")

同时，把模板里的静态资源引用改成绝对路径（开头加斜杠）：

<script src="/static/someJavascript.js"></script>

这样浏览器会直接从根路径请求静态资源，不受当前路由层级影响。

3. 直接修改模板里的资源引用为绝对路径 #

如果不想改动Flask配置，也可以直接在index.html里把所有静态资源的引用改成绝对路径（开头加/）：

<script src="/static/dist/someJavascript.js"></script>

这种方式最简单，但如果之后静态资源的URL前缀有变化，需要手动修改所有引用，灵活性不如前两种。

关于你的疑问 #

你提到的“全局统一设置static_folder路径”其实是误解了它的作用：static_folder是用来指定Flask从磁盘哪个目录读取静态文件的，而控制URL上的静态资源路径的是static_url_path参数。你遇到的问题是URL路径解析的问题，调整static_url_path或者前端引用方式就能解决，不需要修改static_folder的配置。

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