Scanpy中设置cache=True创建缓存失败，报OSError错误求解决

问题分析 #

你遇到的错误是因为cache=True时，scanpy自动生成缓存文件名的逻辑会把路径中的/替换为-，导致生成的文件名-Users-sandb-OneDrive-UCB-result-scRNAseq-1strun-WT-matrix.h5ad不符合文件系统规范，再加上OneDrive目录可能存在同步权限或文件锁的问题，最终触发了无效参数的OSError。

解决办法 #

• 手动指定缓存路径
  使用cache_path参数自定义缓存文件的位置，避免scanpy自动生成有问题的文件名，同时可以选择非OneDrive的本地目录来规避同步限制：

  WT = sc.read_10x_mtx(
      '/Users/sandb/OneDrive/UCB/result/scRNAseq/1strun/WT',
      var_names='gene_symbols',
      cache=True,
      cache_path='/Users/sandb/LocalCache/WT_matrix.h5ad'
  )
  

• 检查OneDrive目录权限与同步状态
  确保Python进程拥有OneDrive目标目录的读写权限，暂时关闭OneDrive同步再尝试创建缓存文件，或者将10x数据复制到本地非同步目录后再运行代码。

• 手动生成并读取缓存文件
  绕开scanpy的自动缓存逻辑，先读取数据再手动保存为h5ad格式，后续直接读取该缓存文件：

  # 首次读取并保存缓存
  WT = sc.read_10x_mtx('/Users/sandb/OneDrive/UCB/result/scRNAseq/1strun/WT', var_names='gene_symbols', cache=False)
  WT.write('/Users/sandb/LocalCache/WT_matrix.h5ad')
  
  # 后续直接读取缓存
  WT = sc.read('/Users/sandb/LocalCache/WT_matrix.h5ad')
  

内容的提问来源于stack exchange，提问作者Byung Chul Jung