结合runpy使用mock的测试单独运行通过，与其他测试同跑即使率先执行也失败

问题根因 #

你遇到的是Python单元测试mock和模块导入缓存的典型共性问题，核心原因有3个：

• 当前的mock配置写法有缺陷，无法覆盖dynamic_script.py内创建的所有boto3客户端实例
• 测试框架用例收集阶段可能提前导入过目标脚本，导致脚本顶层代码提前执行、boto3客户端在mock生效前就已经完成实例化
• mock的目标路径不符合在哪里调用就patch在哪里的原则，作用域无法覆盖目标脚本的调用逻辑

修复方案 #

1. 修正mock配置写法 #

你当前的mock_boto3_client().head_object.return_value = {}写法，仅会对本次临时调用生成的mock实例生效，后续脚本内调用boto3.client生成的新实例不会继承该配置。调整写法如下：

from runpy import run_path
from unittest.mock import patch, MagicMock
import sys

@patch('boto3.client', autospec=True)
def test_scripts(mock_boto3_client: MagicMock):
    # 统一配置所有boto3.client调用返回的实例行为
    mock_client = MagicMock()
    mock_client.head_object.return_value = {}
    mock_boto3_client.return_value = mock_client
    # 先清除可能存在的模块缓存，避免提前执行的代码不受mock控制
    if 'src.scripts.dynamic_script' in sys.modules:
        del sys.modules['src.scripts.dynamic_script']
    run_path(
      'src/scripts/dynamic_script.py',
      run_name='__main__'
    )

2. 调整patch目标路径（可选，根据脚本导入方式调整） #

如果dynamic_script.py内采用from boto3 import client的方式导入并调用客户端，你需要将patch目标改为脚本内的导入位置，而非原始的boto3.client：

# 假设脚本内是 from boto3 import client 后直接调用client()
@patch('src.scripts.dynamic_script.client', autospec=True)
def test_scripts(mock_client: MagicMock):
    # 后续配置逻辑同上

3. 调整脚本执行逻辑（可选，从根源避免缓存问题） #

如果dynamic_script.py内存在大量顶层执行代码（非函数封装的代码），建议将核心逻辑封装到main函数内，仅在__name__ == "__main__"时调用：

# dynamic_script.py 调整后示例
import boto3

def main():
    s3 = boto3.client('s3')
    s3.head_object(Bucket='test', Key='test')

if __name__ == "__main__":
    main()

调整后你可以直接导入脚本调用main函数测试，无需使用run_path，完全规避模块导入缓存的副作用。

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