【Bug已解决】test_mset_chmod fails on Windows due to unsupported chmod permission bits一、现象长什么样某个涉及mset批量写入键值比如缓存/存储后端的测试里有一项test_mset_chmod写入后给文件设置权限位如os.chmod(path, 0o600)用来验证存储能正确应用权限。这个测试在 Linux/macOS 上绿但在Windows 上失败。原因Windows 的os.chmod不支持 Unix 风格权限位owner/group/other 的 rwx如0o600/0o644。Windows 的权限模型完全不同ACLos.chmod在 Windows 上只认stat.S_IWRITE/stat.S_IREAD等少数标志传0o600要么无效、要么抛OSError/NotImplementedError测试因此红。现象CI 的 Windows runner 上test_mset_chmod直接报错而开发机Unix一直绿导致本地过了 CI 挂的跨平台不一致。二、背景os.chmod在 POSIX 系统设置的是 Unix 权限位owner/group/others 的读/写/执行这是 POSIX 语义。Windows 没有这套位Python 的os.chmod在 Windows 实现只映射了只读/可写两个概念stat.S_IREAD/stat.S_IWRITE对其他位要么忽略要么报错。测试代码写了os.chmod(path, 0o600) # Unix 语义Windows 不支持这在 Windows 上要么静默不生效权限没按预期设要么因传了不支持的组合报错。问题是测试假设了 Unix 文件系统语义未做平台判断。三、根因根因两点测试假设 Unix 语义test_mset_chmod直接用0o600这类 Unix 权限位未考虑 Windows。无平台守卫测试没用sys.platform判断在 Windows 上仍跑 Unix 专属断言。本质把Unix 文件系统权限当成跨平台通用能力忽略了 Windows 根本不支持这套权限模型。四、最小可运行复现下面缩略逻辑复现 Windows 失败import os, sys def test_mset_chmod(path): # 在 Windows 上 os.chmod(path, 0o600) 不支持 if sys.platform win32: try: os.chmod(path, 0o600) except (OSError, NotImplementedError) as e: print(Windows 上失败:, e) # 测试红 else: os.chmod(path, 0o600) # Unix 正常修复Windows 用 Windows 支持的标志或跳过该断言。import os, sys, stat def apply_permissions(path): if sys.platform win32: os.chmod(path, stat.S_IREAD) # Windows: 只读标志 else: os.chmod(path, 0o600)五、解决方案第一层最小直接修复最小修法测试里按平台分支test_mset_chmod在 Windows 用 Windows 支持的权限标志或仅验证文件可写性而非具体位Unix 才用0o600。import os, sys, stat import pytest pytest.mark.skipif(sys.platform win32, reasonWindows lacks Unix chmod permission bits) def test_mset_chmod_unix(path): store.mset({k: v}) p store.path_for(k) os.chmod(p, 0o600) assert os.stat(p).st_mode 0o777 0o600 def test_mset_writable_win(path): # Windows 仅验证可写不校验具体位 store.mset({k: v}) p store.path_for(k) assert os.access(p, os.W_OK)这一层让 Windows 不再因 Unix 权限位失败。六、解决方案第二层结构化改进把权限测试的平台策略固化成策略对象作为单一事实来源明确哪些位在哪些平台有效。import sys, stat from dataclasses import dataclass, field from typing import Dict dataclass(frozenTrue) class LangChainMsetChmodPolicy: mset 权限测试平台策略的单一事实来源。 unix_bits: int 0o600 windows_bits: int stat.S_IREAD platform: str field(default_factorylambda: sys.platform) def applicable_bits(self) - int: if self.platform win32: return self.windows_bits return self.unix_bits def should_run_unix_assert(self) - bool: return self.platform ! win32 def validate(self) - None: if self.platform win32 and self.unix_bits not in (0, ): # 在 Windows 上不应传 unix 位 pass测试用policy.applicable_bits()/should_run_unix_assert()平台差异集中。七、解决方案第三层断言 / CI 守护用 pytest 锁死平台策略import pytest, sys, stat from policy import LangChainMsetChmodPolicy as P def test_windows_uses_read_flag(): p P(platformwin32) assert p.applicable_bits() stat.S_IREAD def test_unix_uses_600(): p P(platformlinux) assert p.applicable_bits() 0o600 def test_skip_unix_assert_on_win(): p P(platformwin32) assert p.should_run_unix_assert() is False def test_unix_runs_assert(): p P(platformdarwin) assert p.should_run_unix_assert() is TrueCI 加一条在 Windows runner 上跑test_mset_chmod断言不再因0o600失败用 windows_bits 或 skip。八、排查清单test_mset_chmod在 Windows 红→os.chmod(0o600)Windows 不支持。测试是否假设 Unix 语义→ 需平台分支/跳过。Windows 用哪些 chmod 标志→ 仅 S_IREAD/S_IWRITE。是否该跳过而非硬改→ Unix 专属断言在 Windows skip。本地绿 CI 红→ 跨平台权限模型差异需平台守卫。是否有平台策略测试→ 必须有。九、小结test_mset_chmod用 Unix 权限位0o600做断言而 Windows 的os.chmod不支持这套位导致测试在 Windows CI 失败。根因是测试假设了 Unix 文件系统语义、无平台守卫。第一层按sys.platform分支Windows 用S_IREAD或 skip第二层用LangChainMsetChmodPolicy把权限测试的平台策略固化成单一事实来源第三层用 pytest 守护跨平台一致。跨平台测试的通用原则凡涉及文件系统权限位必须按平台分支或跳过 Unix 专属断言不能用 Unix 语义假设所有系统。
