python-sandbox-path-isolation.md

domain	contrib
title	Python 沙箱/受限环境 — PATH 和 sys.path 隔离
verification	metadata-normalized
{"title"	Python 沙箱/受限环境 — PATH 和 sys.path 隔离", "domain": "development", "tags": ["python", "sandbox", "path", "import", "venv"], "domain_expert": "unknown"}
created	2026-07-06
source	unknown

背景

在沙箱或受限环境中执行 Python 代码时，import 报 ModuleNotFoundError，或 import 的是宿主环境的包而非沙箱环境的。

根因

Python sys.path 继承自父进程，沙箱未正确隔离 PYTHONPATH、PATH 和 sys.path。

修复

import sys
import os

# Python 沙箱/受限环境 — PATH 和 sys.path 隔离
print("Python:", sys.executable)
print("sys.path:", sys.path)

# 2. 确认是否在正确的 venv 中
import site
print("site-packages:", site.getsitepackages())

# 3. 强制指定解释器（在 shell 中）
/path/to/venv/bin/python script.py

# 4. 在沙箱中临时添加路径
sys.path.insert(0, "/path/to/venv/lib/python3.12/site-packages")

# 5. 检查 PATH（子进程会继承）
os.environ["PATH"] = "/path/to/venv/bin:" + os.environ.get("PATH", "")

# 6. 验证 import 来源
import requests
print(requests.__file__)  # 应指向正确的 venv

Verification

1. Follow the solution steps in order
2. Run any relevant commands or tests to confirm the fix
3. Verify the symptom no longer occurs
4. Check related logs or outputs for expected behavior

陷阱

• subprocess.run("python script.py", ...) 用的不是当前 Python——python 可能是系统默认的
• 总是用 sys.executable 来调用子进程：subprocess.run([sys.executable, "script.py"])