偶现文件访问异常求助：Python写入settings.json时Errno22报错

场景回顾 #

用户代码：

with open(self.filename,'w') as fp:
    json.dump(self.settings, fp)

偶尔抛出的错误：

[Errno 22] Invalid argument: 'settings.json'

已知背景：文件确实存在、文件名无特殊字符、未使用多线程、异常出现概率不足1%、重试1次通常可解决。

可能的原因 #

• 系统级临时资源竞争：即使你的代码是单线程，操作系统里的其他进程（比如杀毒软件实时扫描、系统文件索引服务、自动备份工具）可能会临时锁定这个文件，导致你的进程打开时冲突。这类冲突都是瞬时的，重试就能避开。
• 磁盘I/O瞬时异常：如果是机械硬盘或者网络挂载的存储，偶尔会出现I/O队列阻塞、缓存同步延迟的情况，有些系统会把这类底层I/O问题映射成「无效参数」的错误码，重试时I/O恢复正常就没问题了。
• 文件描述符临时耗尽：极端情况下系统可用的文件描述符被其他进程占满，此时打开文件会返回异常错误码，不过单线程场景下这种情况概率极低，且重试能解决说明是临时资源紧张。
• 隐性的文件名编码问题：虽然看起来文件名没特殊字符，但如果文件名是动态生成的，偶尔可能混入不可见的Unicode控制字符（比如零宽空格），不过这种情况应该是每次都报错，如果你文件名固定可以排除。

验证与优化建议 #

• 重试时加个短暂延迟（比如time.sleep(0.1)），如果能减少重试次数，就说明是瞬时资源冲突导致的。
• 异常出现时查看系统日志（Windows看事件查看器，Linux看syslog），有没有磁盘或文件系统相关的警告信息。
• 如果是网络共享盘，优先排查网络波动或者存储端的临时故障。

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