Supervisor管理的Prefect本地代理中ShellTask执行失败求助

1. 修复Supervisor的PATH配置与命令执行逻辑 #

你的Supervisor配置里environment的PATH设置不完整，且source activate在非交互式shell环境下可能无法正常生效。修改配置如下：

[program:prefect-agent]
environment=PATH="/home/user/venv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
command = /home/user/venv/bin/prefect agent local start
autostart=true
autorestart=true

直接用虚拟环境内prefect命令的绝对路径启动代理，避免依赖shell的source操作；同时补充系统默认PATH，防止ShellTask执行时找不到基础系统命令。

2. 确保Shell脚本具备执行权限 #

执行以下命令为目标脚本添加可执行权限：

chmod +x /home/user/some_shell_script.sh

3. 给ShellTask指定明确的执行Shell #

在ShellTask中显式指定bash路径，避免环境差异导致的执行问题：

@task(name="task1", skip_on_upstream_skip=False, log_stdout=True)
def task1(data):
    logger = prefect.context.get("logger")
    cmd = ShellTask(
        command=f"/home/user/some_shell_script.sh",
        stream_output=True,
        log_stderr=True,
        shell="/bin/bash"  # 强制指定bash作为执行shell
    )
    cmd.run()
    return data

同时确保你的shell脚本开头添加#!/bin/bash声明，强制脚本用bash解释执行：

#!/bin/bash
# 此处为你的脚本内容

4. 查看Supervisor日志定位具体错误 #

如果上述操作后仍未解决，查看Supervisor的日志文件（通常位于/var/log/supervisor/目录下），或用以下命令查看实时日志：

supervisorctl tail -f prefect-agent

日志会显示ShellTask执行失败的具体原因（如命令找不到、权限不足等），可针对性调整。

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