GitHub Actions自托管环境无法找到venv目录下已安装的包可执行文件

核心触发原因 #

你遇到的「文件存在但执行提示找不到」的报错，本质上不是文件路径不存在，而是二进制执行的前置依赖不满足导致的系统误报，结合自托管GitHub Actions runner的场景，常见原因和解决方法如下：

• 1. 二进制架构和运行环境不匹配
  如果你安装的包携带预编译的二进制，而预编译版本的架构（比如x86_64和arm64不兼容）和你自托管节点的CPU架构不符，执行时就会触发该报错。
  排查方法：执行file 完整路径/mybinary查看二进制架构，和节点执行arch返回的结果做对比。
  解决方法：卸载当前包，重新从源码编译安装，或者安装对应架构的包版本。
• 2. 动态链接依赖缺失
  如果是动态编译的二进制，依赖的系统so库不存在时也会报该错误，不是二进制本身找不到，是依赖的库找不到。
  排查方法：执行ldd 完整路径/mybinary，查看输出中标记为not found的依赖项。
  解决方法：安装缺失的依赖库，比如缺libssl.so.1.1就安装对应版本的openssl依赖包。
• 3. 脚本shebang指向的解释器不存在
  如果mybinary是Python脚本，第一行的shebang配置（比如#!/usr/local/bin/python3.9）指向的解释器路径在节点上不存在，也会触发该报错。
  排查方法：执行head -n1 完整路径/mybinary查看shebang配置，确认对应路径的解释器存在。
  解决方法：把shebang改为#!/usr/bin/env python，适配虚拟环境的Python路径，或者重新用虚拟环境内的pip重装对应包，自动生成正确的shebang。
• 4. SELinux安全策略拦截
  如果自托管节点开启了SELinux，runner进程的安全上下文没有对应路径下的二进制执行权限，也可能触发类似报错。
  排查方法：临时执行setenforce 0关闭SELinux后再尝试执行，看是否恢复正常。
  解决方法：给对应二进制文件添加允许执行的SELinux安全上下文，或者调整runner进程的权限规则。

临时调试步骤 #

你可以在工作流的Do commands步骤中加入以下调试命令，快速定位问题：

- name: Do commands
  run: |
    source venv/bin/activate
    cd mydir
    # 确认文件存在和权限
    ls -la $VIRTUAL_ENV/bin/mybinary
    # 查看二进制类型和架构
    file $VIRTUAL_ENV/bin/mybinary
    # 查看动态依赖
    ldd $VIRTUAL_ENV/bin/mybinary
    # 全路径执行测试
    $VIRTUAL_ENV/bin/mybinary

额外配置检查 #

你贴出的工作流YAML存在两处语法错误，若实际配置也是如此需要修正：

1. runs_on 应该改为GitHub Actions标准字段 runs-on
2. workflow_dispatch 末尾需要加冒号，即 workflow_dispatch:

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