You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何离线运行Jupyter Dash 配置serve_locally仍白屏无报错怎么解决

离线环境Jupyter Dash白屏问题排查解决方案
  • 调整配置加载顺序与启动参数
    现有代码在layout定义完成后才设置本地资源加载规则,可能已触发预加载逻辑请求在线资源;同时mode="Inline"参数拼写错误,正确取值为全小写的inline。配置需在初始化app后、定义layout前完成设置,旧版本Dash还需要额外添加Plotly.js的本地加载配置,修正后的基础配置示例:
    from jupyter_dash import JupyterDash
    import dash_core_components as dcc
    import dash_html_components as html
    
    app = JupyterDash('offline example')
    # 所有本地资源配置放在最前面
    app.css.config.serve_locally = True
    app.scripts.config.serve_locally = True
    # 兼容旧版本Dash的Plotly.js本地加载配置
    app.plotlyjs.serve_locally = True
    
    app.layout = html.Div([
        dcc.Graph(id='my-graph', figure={'data': [{'x': [1, 2, 3], 'y': [4, 1, 2]}]})
    ])
    
    if __name__ == '__main__':
        # 参数为全小写
        app.run_server(mode="inline")
    
  • 验证依赖完整性
    离线环境需确保所有关联包已完整安装,无缺失静态资源:
    • 核心依赖包:dash、jupyter-dash、dash-core-components、dash-html-components、plotly
    • 若使用JupyterLab,需提前离线安装对应扩展:jupyter-dash、@jupyter-widgets/jupyterlab-manager,扩展可在联网环境预下载后导入离线设备安装
  • 替换渲染模式排查问题
    • 先将启动参数改为app.run_server(mode="external"),访问输出的本地服务地址测试是否正常加载,排除Jupyter内嵌iframe的权限限制
    • 若external模式正常、inline模式白屏,可尝试改为mode="jupyterlab"适配当前编辑器环境
  • 极端情况手动指定静态资源
    若以上步骤无效,可提前在联网环境下载Dash全量静态资源包,放置到项目目录后通过app.css.append_css、app.scripts.append_script手动指定本地资源路径即可。

内容的提问来源于stack exchange,提问作者Ikaryssik

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.07 02:18:03