👁 74 次阅读

Dify 代码执行节点为何偶发 502 失败？

来源：https://github.com/langgenius/dify/issues/40603

现象描述

在 Dify 自托管（Self Hosted，源码部署）环境中，工作流里的代码执行节点会出现偶发失败。据 issue #40603 报告者 Zingway 描述，该问题并非稳定复现，而是”occasional issue”（偶发问题）。 Dify API 侧记录的详细错误日志如下：

ERROR [error_handler.py:101]  Node 1773910518871 failed with ABORT strategy: Failed to execute code, which is likely a network issue, please check if the sandbox service is running. ( Error: Failed to execute code, got status code 502, please check if the sandbox service is running )
ERROR [workflow_entry.py:116] 741ccd314f Unknown

从报错文本看，代码执行节点调用 sandbox 服务时收到 HTTP 502，工作流随即以 ABORT 策略终止。报告者的预期行为是”Code execution node normal”，即代码执行节点正常返回，而实际行为字段未填写。报告环境信息：

Dify 版本：1.11.2
部署方式：Self Hosted (Source)
dify-sandbox 版本：0.2.12

背景原因

issue 中给出的线索指向 dify-sandbox 容器自身的日志。报告者检查 sandbox 容器日志后，发现两类频繁出现的记录。第一类是安装 Python 依赖失败：

2026/08/12 09:03:07 setup.go:146: [ERROR]failed to wait for the command to complete
2026/08/12 09:03:07 server.go:51: [PANIC]failed to install python dependencies: exit status 1

第二类是按固定间隔重复出现的同一错误。报告者称”the following error is reported every two minutes”（以下错误每两分钟上报一次）：

2026/08/12 09:06:34 server.go:51: [PANIC]failed to install python dependencies: exit status 1

报告者提出了一个待验证的假设：python-requirements.txt 文件确实存在于 docker/volumes/sandbox/dependencies/ 目录中，是否是文件里定义的包触发了 pip 安装，进而引发了上述 PANIC。报告者在摘要末尾写道”The preced…”，句子被截断，未给出完整结论。需要说明的是，sandbox 依赖安装失败与 API 侧收到的 502 之间是否存在因果关系，issue 中并未确认。报告者本人在描述该日志时也明确表示”I’m not sure if they are related to the aforementioned issue”（不确定这些日志是否与前述问题相关）。依赖安装报错的核心现象，是容器内的 pip 安装过程以 exit status 1 退出，触发服务端 PANIC。在容器化部署中，沙箱服务启动时若依赖未就绪，其对外提供代码执行能力的时间窗与可用性会受到影响——这一点属于对日志现象的合理推断，而非 issue 中已确认的结论。

排查或量化方法

当前 issue 处于 open 状态，官方尚无实质回复，因此这里只归纳 issue 中报告者已经执行的动作，不引入事实之外的排查步骤。报告者实际完成的定位动作包括：

确认问题为偶发，而非每次执行代码节点都失败
提取 Dify API 侧的完整错误日志，定位到 error_handler.py:101 与 workflow_entry.py:116 两条记录
记录 Dify 版本（1.11.2）与 dify-sandbox 版本（0.2.12）
检查 dify-sandbox 容器日志，抓取 setup.go:146 与 server.go:51 两处报错
观察报错频率，确认 failed to install python dependencies: exit status 1 约每两分钟出现一次
核实 docker/volumes/sandbox/dependencies/ 目录下确实存在 python-requirements.txt 文件

据 issue 讨论，可复用的定位信息集中在两处： 1. 应用层：代码执行节点返回 502，报错文本指向 sandbox 服务是否运行 2. 沙箱层：server.go:51 的 PANIC 由 Python 依赖安装失败引起两层日志之间的关联性仍为待验证项。

当前处理路径与局限

由于 issue 仍为 open，且剔除机器人留言后的实质评论仅来自报告者本人，官方尚未给出实质回应。本节只陈述 issue 中已经出现的动作与信息，不补写事实之外的修复步骤。报告者提出的处理线索是 python-requirements.txt：

文件位于 docker/volumes/sandbox/dependencies/ 目录
报告者怀疑文件中定义的包会触发 pip 安装，从而引发 failed to install python dependencies: exit status 1
该猜测在 issue 中并未得到验证

已知的报错链：

server.go:51: [PANIC]failed to install python dependencies: exit status 1

setup.go:146: [ERROR]failed to wait for the command to complete

Failed to execute code, got status code 502, please check if the sandbox service is running

这条链条的每一环都有原始日志支撑，但环与环之间的因果连接尚无结论。在官方给出回应之前，能确认的事实仅限于：特定版本的 dify-sandbox（0.2.12）在自托管环境下，会周期性出现依赖安装失败，并且 API 侧会在偶发场景下收到 502。

参数或对比表格

项目	issue 中给出的值
Dify 版本	1.11.2
部署方式	Self Hosted (Source)
dify-sandbox 版本	0.2.12
应用层错误文件	`error_handler.py:101`、`workflow_entry.py:116`
沙箱层错误文件	`setup.go:146`、`server.go:51`
应用层错误码	502
沙箱层错误文本	`failed to install python dependencies: exit status 1`
报错频率	约每两分钟一次
依赖文件路径	`docker/volumes/sandbox/dependencies/python-requirements.txt`
问题性质	偶发
issue 状态	open
实质评论条数	4

常见错误排查

issue 中未提供系统性的排查清单，以下条目均直接来源于报告者的描述，不含事实之外的推断。

代码执行节点偶发失败、报 502：核对 API 日志中 error_handler.py:101 与 workflow_entry.py:116 是否出现同样的 ABORT 记录。
sandbox 依赖安装报错：检查 dify-sandbox 容器日志中是否存在 server.go:51: [PANIC]failed to install python dependencies: exit status 1。
依赖安装前置步骤异常：留意 setup.go:146: [ERROR]failed to wait for the command to complete 是否同时出现。
依赖文件是否存在：确认 docker/volumes/sandbox/dependencies/ 下是否有 python-requirements.txt。
报错频率判断：观察 failed to install python dependencies 是否按固定间隔（报告者观察为约两分钟）重复出现。

实践建议

基于 issue #40603 已披露的信息，可以提炼的实践要点如下。

记录完整版本号。报告者同时给出 Dify 1.11.2 与 dify-sandbox 0.2.12，这为后续定位提供了基本坐标。仅报告”Dify 某版本”不足以缩小范围。
区分应用层与沙箱层日志。API 侧的 502 是症状，sandbox 侧的 PANIC 是另一层现象，两层日志需要分别采集，再判断关联。
关注周期性报错。约每两分钟复现一次的依赖安装失败，比随机报错更容易定位，也更容易被误当作背景噪音忽略。
对偶发问题保留时间戳。报告者给出的 2026/08/12 09:03:07 与 2026/08/12 09:06:34 属于可对齐的锚点，有助于把应用层 502 与沙箱层 PANIC 做时间比对。
明确区分”已确认”与”待验证”。该 issue 中，依赖安装失败与 502 的关系仍属报告者的猜测，在官方回应前不宜当作定论使用。

FAQ

Dify 代码执行节点的 502 报错是什么原因？ 据 issue #40603，Dify API 返回的报错为 Failed to execute code, got status code 502, please check if the sandbox service is running。同一 issue 中，dify-sandbox 容器日志出现 [PANIC]failed to install python dependencies: exit status 1。两者是否直接相关，issue 中尚未确认。 这个问题是每次都会出现吗？ 不是。报告者明确描述为”occasional issue”，即偶发问题。 sandbox 依赖安装失败多久出现一次？ 报告者观察到的频率是每两分钟一次。日志中的时间戳为 2026/08/12 09:06:34，错误行为 server.go:51: [PANIC]failed to install python dependencies: exit status 1。 python-requirements.txt 与此有关吗？ 报告者确认该文件存在于 docker/volumes/sandbox/dependencies/ 目录中，并猜测其中的包会触发 pip 安装进而导致报错。这属于猜测，issue 中未给出验证结果。 官方是否已经回复或修复？ issue #40603 当前状态为 open，创建于 2026-08-12，最后更新同为 2026-08-12，标签为 🐞 bug。剔除机器人或无效留言后，实质评论共 4 条，均来自报告者本人。官方侧尚无实质回应，也没有修复版本或处理方案公布。