Python subprocess调用编译后Matlab程序时环境变量无法传递求助

问题背景 #

在Linux Docker容器里用Python 3.9.15的subprocess.run调用编译后的Matlab程序，这个Matlab程序会调用一个依赖环境变量的外部程序。直接在命令行跑Matlab程序时，环境变量能正常传递，程序运行没问题；但用subprocess跑相同命令时，环境变量传不过去——虽然Python里os.getenv()能拿到正确变量，os.environ.copy()生成的my_env也包含这些变量。目前临时用os.system加日志文件的方案凑合用，但想换回subprocess直接获取stdout和stderr。

具体解决建议 #

1. 别用shell=True，改用列表传命令参数 #

shell=True会启动子shell，Docker环境下的shell配置可能过滤或重置环境变量。直接用列表传参，跳过shell层，环境变量传递更直接，还能避免引号转义的坑。

import os
import subprocess as sp
import logging

log = logging.getLogger(__name__)

my_env = os.environ.copy()
# 把命令拆成列表，每个参数单独放，文件路径不用加引号
cmd = [
    '<abs path to my compiled program>/<compiled program>',
    path_to_file  # 这里直接传变量，不用手动加引号
]
log.info(f"调用Matlab程序的命令: {' '.join(cmd)}")
res = sp.run(cmd, capture_output=True, text=True, env=my_env)

# 处理结果
if res.returncode != 0:
    log.error(f"程序运行失败，错误信息: {res.stderr}")
else:
    log.info(f"程序输出: {res.stdout}")

2. 只传递需要的关键环境变量 #

有时候os.environ.copy()会带一些Python进程或Docker特有的变量，可能干扰Matlab程序。可以只挑外部程序需要的变量传，减少冲突：

import os
import subprocess as sp
import logging

log = logging.getLogger(__name__)

# 列出外部程序必须的环境变量，比如EXTERNAL_PROG_VAR是依赖的变量，PATH和LD_LIBRARY_PATH通常也需要
required_vars = ['EXTERNAL_PROG_VAR', 'PATH', 'LD_LIBRARY_PATH']
my_env = {var: os.getenv(var) for var in required_vars if os.getenv(var) is not None}

# 或者全量复制后删掉可能冲突的变量，比如Python相关的PYTHONPATH
# my_env = os.environ.copy()
# del my_env['PYTHONPATH']

cmd = [
    '<abs path to my compiled program>/<compiled program>',
    path_to_file
]
res = sp.run(cmd, capture_output=True, text=True, env=my_env)

3. 必须用shell的话，显式指定bash登录shell #

如果因为某些原因必须保留shell=True，可以指定用bash的登录模式启动——直接命令行用的是交互式bash，会加载~/.bashrc之类的配置，而subprocess默认的sh不会。用bash -l -c强制加载环境配置：

import os
import subprocess as sp
import logging

log = logging.getLogger(__name__)

my_env = os.environ.copy()
# 注意路径里的引号要转义，避免shell解析出错
cmd = f'bash -l -c "<abs path to my compiled program>/<compiled program> \\"{path_to_file}\\""'
res = sp.run(cmd, shell=True, capture_output=True, text=True, env=my_env)

4. 先验证环境变量是否真的传到子进程 #

如果前面的方法都不行，先排除subprocess本身的问题：写个简单的shell脚本打印环境变量，用subprocess调用它，看变量能不能传过去。
比如写个print_env.sh：

#!/bin/bash
echo "目标环境变量值: $EXTERNAL_PROG_VAR"
env  # 打印所有环境变量

然后用subprocess调用：

res = sp.run(['/path/to/print_env.sh'], capture_output=True, text=True, env=my_env)
print(res.stdout)

如果这个脚本能拿到正确的变量，说明问题出在Matlab编译程序或者它调用的外部程序上，得去查它们读取环境变量的逻辑。

总结 #

优先试试列表传参+去掉shell=True，这是最稳妥的方式，能避开shell层的环境变量干扰。如果必须用shell，就指定bash登录模式。还搞不定的话，用测试脚本验证环境变量传递情况，定位问题根源。

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