Plotly Dash点击按钮下载本地文件功能失效如何解决？

方案1：使用assets静态资源路径（适合固定不变的文件） #

这是最简便的实现方式，你之前的问题是路径配置错误，按以下步骤调整即可：

• 确认工程根目录下存在命名为assets的文件夹，将目标xxx.xlsx文件放入该文件夹
• 按钮的href属性必须补全/assets/前缀，不能直接写文件名
• external_link设置为True即可，作用是避免Dash将链接识别为内部路由跳转

修改后的按钮代码示例：

dbc.Button(
    "download",
    href='/assets/xxx.xlsx',
    external_link=True,
    color="primary",
)

方案2：回调动态返回文件（适合动态生成、不想放在assets目录的文件） #

这种方式灵活度更高，不受文件存放路径限制：

• 先导入依赖组件：from dash import dcc, callback, Input, Output
• 布局中新增dcc.Download组件用于触发下载行为
• 给按钮绑定回调，点击时返回目标文件

完整代码示例：

# 布局部分
app.layout = dbc.Container([
    dbc.Button(
        "download",
        id="download-btn",
        color="primary",
    ),
    dcc.Download(id="download-excel")
])

# 回调部分
@callback(
    Output("download-excel", "data"),
    Input("download-btn", "n_clicks"),
    prevent_initial_call=True,
)
def download_file(n_clicks):
    # 此处填写目标文件的相对路径或绝对路径
    return dcc.send_file("你的自定义路径/xxx.xlsx")

注意事项 #

• 使用方案1时，可以先直接在浏览器访问http://你的服务地址/assets/xxx.xlsx测试资源是否可访问，能正常访问的情况下按钮必然生效
• 文件名避免使用中文、特殊字符，防止编码问题导致资源加载失败

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