能否在Shebang中使用符号链接指向Python虚拟环境运行脚本？

在新Linux服务器上搭建了Python虚拟环境，但一批无法修改的脚本Shebang指向旧服务器的Python路径。尝试创建旧路径的目录结构，用符号链接指向新虚拟环境的Python，但使用符号链接时脚本找不到虚拟环境中的包，直接指定虚拟环境路径则能正常运行。

创建符号链接的命令 #

ln -s /opt/test/test_venv368/bin/python3 /opt/{old_server_path}/python

符号链接方式运行失败 #

脚本代码 #

#!/opt/{old_server_path}/python
import sys
print(sys.executable)
import pyodbc
modulenames = set(sys.modules) & set(globals())
allmodules = [sys.modules[name] for name in modulenames]
print(allmodules)

输出 #

/opt/{old_server_path}/python
Traceback (most recent call last):
  File "./testvenv3.py", line 4, in <module>
    import pyodbc
ModuleNotFoundError: No module named 'pyodbc'

直接指定虚拟环境路径运行成功 #

脚本代码 #

#!/opt/test/test_venv368/bin/python
import sys
print(sys.executable)
import pyodbc
modulenames = set(sys.modules) & set(globals())
allmodules = [sys.modules[name] for name in modulenames]
print(allmodules)

输出 #

/opt/test/test_venv368/bin/python
[<module 'sys' (built-in)>, <module 'pyodbc' from '/opt/test/test_venv368/lib64/python3.6/site-packages/pyodbc.cpython-36m-x86_64-linux-gnu.so'>]

原因分析 #

Python虚拟环境依赖根目录下的pyvenv.cfg文件定位site-packages等依赖路径。当使用符号链接指向虚拟环境的Python时，Python启动时会在符号链接所在目录的父级查找pyvenv.cfg，而非原虚拟环境的根目录，导致找不到配置文件，从而切换到系统默认Python环境，无法加载虚拟环境中的包。

解决方案 #

1. 复制pyvenv.cfg到符号链接的父目录 #

• 创建旧路径的父目录：

  mkdir -p /opt/{old_server_path}/../
  

• 复制虚拟环境的配置文件到该目录：

  cp /opt/test/test_venv368/pyvenv.cfg /opt/{old_server_path}/../
  

  这样Python启动时就能找到正确的配置文件，加载虚拟环境的依赖。

2. 使用硬链接替代符号链接 #

硬链接会让文件与原文件共享inode，Python会识别到原始路径的pyvenv.cfg，命令如下：

ln /opt/test/test_venv368/bin/python3 /opt/{old_server_path}/python

注意：硬链接不能跨文件系统使用，若旧路径和虚拟环境路径不在同一分区则无法生效。

3. 用Wrapper脚本代替符号链接 #

在旧路径下创建名为python的脚本，内容如下：

#!/bin/bash
exec /opt/test/test_venv368/bin/python3 "$@"

给脚本添加执行权限：

chmod +x /opt/{old_server_path}/python

脚本Shebang指向该Wrapper时，会实际调用虚拟环境的Python，且能正确加载依赖。

4. 环境变量方式不可行 #

脚本通过Shebang直接执行时，系统会忽略用户配置中的环境变量（如PATH），无法强制指定Python路径，因此该方法不适用。

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