如何在Python的pytest中禁止使用本地文件系统IO操作？

核心目标 #

阻断所有直接本地文件操作，仅允许通过fsspec调用加密存储，让任何意外的本地IO在测试阶段直接失败，避免云端部署隐患。

基于pyfakefs的快速实现 #

pyfakefs可以通过简单配置实现完全禁用真实本地文件系统：

• 利用Patcher的allow_real_filesystem=False参数，强制所有文件操作走虚拟文件系统，且无法访问真实本地路径
• 全局自动fixture示例：

import pytest
from pyfakefs.fake_filesystem_unittest import Patcher

@pytest.fixture(autouse=True)
def lock_local_filesystem():
    with Patcher(allow_real_filesystem=False) as patcher:
        # 仅放行加密存储的关联路径（如果需要）
        patcher.fs.add_real_directory("/your/encrypted/storage/mount", read_only=False)
        yield

轻量自定义方案（无第三方依赖） #

如果不想引入pyfakefs，直接monkey-patch标准库IO方法即可：

import pytest
import builtins
import os
from pathlib import Path

@pytest.fixture(autouse=True)
def block_local_io():
    # 备份原始方法
    orig_open = builtins.open
    orig_os_open = os.open
    orig_path_init = Path.__init__

    # 定义阻断函数
    def block(*args, **kwargs):
        raise PermissionError("禁止本地文件IO，请使用fsspec操作加密存储")

    # 替换核心IO入口
    builtins.open = block
    os.open = block
    Path.__init__ = block

    yield

    # 恢复原始方法
    builtins.open = orig_open
    os.open = orig_os_open
    Path.__init__ = orig_path_init

额外防护：静态代码检查 #

配合静态分析工具提前拦截违规代码：

• 编写flake8/pylint自定义规则，扫描代码中直接调用open、os.path、pathlib的场景
• 在CI流程中加入该检查，阻止违规代码合并

最佳实践 #

1. 全局自动fixture：确保所有测试用例默认禁用本地IO，无需逐个配置
2. 异常提示明确：在阻断异常中清晰说明正确做法，降低开发者排查成本
3. 分层管控：测试阻断+静态检查，从编码到测试全流程防控

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