为何Dash程序在Jupyter Notebook可运行但在服务器上无法执行?
服务器环境运行代码失败的具体原因与排查方向
- 文件路径不匹配导致的读取失败
你通过SCP命令将data.json上传到了服务器的/directory绝对路径下,但代码中读取文件用的是相对路径gpd.read_file('data.json')。相对路径会基于Python进程的启动工作目录查找文件,只要你启动脚本时不是在/directory目录下执行命令,就会直接触发FileNotFoundError,提示找不到data.json文件。
本地Jupyter Notebook能正常运行,是因为Notebook的工作目录默认和存储的ipynb文件同级,刚好和data.json的路径匹配。修复方式两种选其一:- 将
data.json移动到和Dash脚本相同的目录下,从该目录启动Python进程 - 直接在代码中写绝对路径:
df= gpd.read_file('/directory/data.json').to_crs("EPSG:4326")
- 将
- 代码原生逻辑缺陷,和部署环境无关
- 全脚本没有导入
norm对象就直接调用其方法,运行到计算upper_bound的代码行时会直接触发NameError: name 'norm' is not defined。你在Notebook中能正常执行,是因为之前的单元格会话已经缓存了from scipy.stats import norm的导入结果,但服务器上启动全新的Python进程运行独立脚本时,没有这个缓存依赖,必然报错。需要在文件开头补上导入语句:from scipy.stats import norm。 - 无GUI的服务器环境下,
swifter库默认会尝试启动交互式进度条组件,在无显示服务的环境下会直接触发执行报错,可通过设置环境变量关闭进度条,或者替换为普通的df.apply执行逻辑。
- 全脚本没有导入
- Dash服务启动配置错误
代码中用app.run_server(debug=True)启动服务时,默认只监听服务器本地的127.0.0.1回环地址,就算所有代码执行完全正常,从服务器外部也无法访问到这个服务,会被误以为是程序运行失败。且debug模式会启动自动重载的子进程,在服务器权限受限的场景下极易报错。正确的生产环境启动参数为:app.run_server(host='0.0.0.0', debug=False) - 文件权限不足导致读取失败
通过SCP上传的data.json默认属主为你的SSH登录账号,如果你是通过其他系统用户(比如gunicorn、nginx、系统服务)启动Python进程,会因为没有文件读取权限触发PermissionError,需要给文件加上对应运行账号的读权限。
内容的提问来源于stack exchange,提问作者Vatandoust
相关产品推荐
相关产品推荐

