Flask中@app.route配置静态资源路径合并为单文件夹如何拆分层级

你遇到的问题核心是路由参数名和视图函数接收参数不匹配，加上相对路径解析逻辑异常导致的，按以下步骤调整即可：

核心错误点 #

你当前路由中定义的路径变量是<path:path>，但视图函数的形参是css_file，二者名称不一致，Flask无法正常传递路径参数，导致路径解析逻辑混乱，最终被识别为单文件夹名称。

修正方法 #

方法1：手动路由配置修正 #

调整参数名，同时显式指定绝对路径避免相对路径解析偏差：

from flask import Flask, send_from_directory
import os

app = Flask(__name__)
# 获取项目启动文件所在的根目录绝对路径
APP_ROOT = os.path.dirname(os.path.abspath(__file__))

# 路由参数名和函数参数名保持一致
@app.route('/assets/css/<path:css_file>')
def send_css(css_file):
    # 拼接得到css文件夹的绝对路径，自动适配操作系统的路径分隔符
    css_folder_path = os.path.join(APP_ROOT, 'assets', 'css')
    return send_from_directory(css_folder_path, css_file)

确保你的本地项目目录结构是如下嵌套形式：

你的项目根目录/
├── app.py（Flask启动脚本）
└── assets/
    └── css/
        └── style.css

修改后访问/assets/css/style.css就会正确读取嵌套二级目录下的文件，不会再将assets/css识别为单文件夹。

方法2：使用Flask原生静态配置（更推荐） #

如果没有特殊的访问控制、路径改写需求，不需要手动写静态资源路由，直接在初始化Flask实例时配置静态资源规则即可：

# 指定静态资源根目录为assets，访问前缀为/assets
app = Flask(__name__,
            static_folder='assets',
            static_url_path='/assets')

配置后框架会自动处理所有/assets/开头的静态资源请求，自动识别嵌套目录结构，不需要额外写视图函数。

验证小技巧 #

可以在视图函数中打印实际查找的文件路径，确认和本地路径匹配：

@app.route('/assets/css/<path:css_file>')
def send_css(css_file):
    css_folder_path = os.path.join(APP_ROOT, 'assets', 'css')
    target_file = os.path.join(css_folder_path, css_file)
    print(f"实际查找的文件路径：{target_file}")
    return send_from_directory(css_folder_path, css_file)

启动服务访问资源后看控制台输出的路径，和你本地文件实际存放的路径一致就说明配置正确。

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