Windows域账户用户访问AppData\Roaming目录文件出现EPERM权限错误

这类lstat调用触发的权限报错确实由Windows域账户漫游配置文件同步机制导致。
Windows域账户开启漫游配置文件同步时，系统的客户端缓存服务（CSC）会在同步AppData\Roaming下的文件时，对正在传输的文件加临时独占锁，该锁会拦截所有读取、写入、元数据查询类的系统调用，不止写入操作会报错，lstat这类查询文件元数据的操作也会触发EPERM/EACCES类错误，这是桌面应用适配Windows域环境的常见踩坑点，大量Electron、Qt类跨端桌面应用都有同类问题记录。

必须针对这类错误做兼容，可按优先级选择以下处理方案：

• 路径拆分：如果你的应用存储的文件不需要跨设备同步，优先迁移到C:\Users\Username\AppData\Local目录下存储，该目录不会被纳入漫游配置文件同步范围，完全不会触发同步锁问题；如果有部分配置数据确实需要跨设备同步，做存储拆分：小体积、低读写频率的配置文件保留在Roaming目录，大文件、缓存类、高频读写的文件全部放到Local目录。
• 错误重试：对lstat、readFile、writeFile等所有文件操作捕获权限类报错，做指数退避重试，重试间隔从100ms递增加到1s，重试3~5次即可覆盖90%以上的临时锁场景，注意不要做无限重试避免进程卡死。
• 打开模式适配：调用文件操作接口时显式指定共享读写模式，Electron的Node.js fs模块、或者原生Windows API调用时，携带FILE_SHARE_READ | FILE_SHARE_WRITE参数，降低和系统同步进程的打开模式冲突概率。

微软有公开的漫游配置文件存储规范：

1. 单文件体积建议不超过256KB，过大的文件会大幅提升同步冲突、锁占用的概率
2. 整个Roaming目录的默认同步阈值为1GB，域管理员可自行调整上限，超出阈值的文件不会被同步
3. 禁止在Roaming目录存储临时文件、缓存文件、日志等高频读写的内容
4. 同步过程中系统会对正在传输的文件加锁，所有用户态进程的访问请求都会被拦截

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