生信报错神医Bio-Error Diagnostics
HTTPS 传输本站不保存日志原文免注册诊断
ERROR LIBRARY · 100

常见生信报错
排查手册

按错误原文找到对应页面,先确认底层原因,再执行检查命令。没有命中的长日志,可以返回诊断工具直接粘贴分析。

诊断完整 Log →
共 100 个

R、单细胞与 Bioconductor

cannot allocate vector of sizeR 报错 cannot allocate vector of size 怎么解决?这是 R 无法继续申请连续内存时最常见的报错。单细胞矩阵、合并对象、转稠密矩阵和并行复制对象都可能瞬间放大内存峰值。R package version conflictR package was built under / version conflict 怎么处理?R、Bioconductor 和系统库之间存在版本矩阵。跨大版本复用旧 library 容易出现 undefined symbol 或命名空间错误。The total size of the globals exported for future expression exceeds the maximum allowed sizeSeurat 报错 future.globals.maxSize:对象太大怎么处理?Seurat 在并行执行 SCTransform、FindMarkers 或整合时,future 会把大对象复制给 worker;对象总量超过限制就会停止。GetAssayData doesn't work for multiple layers in v5 assaySeurat v5:GetAssayData doesn't work for multiple layersSeurat v5 使用 layer 管理不同数据层,旧代码假定单一 slot 时会在多 layer assay 上报错。Cell Ranger insufficient memory Martian RuntimeCell Ranger insufficient memory / pipeline killed 怎么解决?Cell Ranger 会根据阶段并行使用内存。样本 reads、细胞数和参考基因组变大后,默认并发可能把节点内存打满。KeyError highly_variable ScanpyScanpy KeyError: highly_variable 的原因与修复下游分析读取 adata.var['highly_variable'] 时,如果前一步未生成该列、切换了 raw/layer 或对象被裁剪,就会触发 KeyError。package is not available for this version of RR package is not available for this version of RBioconductor 包与 R 大版本严格对应;直接使用 install.packages 往往找不到正确仓库或安装到不兼容版本。lazy-load database is corruptR lazy-load database is corrupt:包缓存损坏修复R 包安装中断、磁盘写入异常或跨版本复制 library 后,*.rdb / *.rdx 文件可能损坏。Error object not found RR 报错 object not found:对象或列名不存在脚本引用了当前环境中不存在的对象、列名或拼写,常见于上一步没有成功执行。could not find function RR could not find function:函数明明安装了为什么找不到?R 找不到函数通常不是语法问题,而是对应包没有加载、版本过旧或函数已经改名。non-conformable arguments RR non-conformable arguments:矩阵维度不匹配矩阵乘法、线性模型或批量运算两侧维度不兼容时,会直接报 non-conformable arguments。subscript out of bounds RR subscript out of bounds:下标越界怎么定位?按行列编号或名称取值时,目标位置超过对象范围就会触发下标越界。replacement has rows data has RR replacement has rows, data has:赋值长度不一致给 data.frame 新列赋值时,右侧长度必须是 1 或与行数一致。cannot open the connection RR cannot open the connection:文件连接打不开read.csv、gzfile 或下载函数无法打开目标路径时会出现此错误。installation of package had non-zero exit statusR package had non-zero exit status:安装失败这句通常只是安装日志最后的汇总,真正原因在前面的编译或依赖报错。failed to lock directory 00LOCK RR failed to lock directory / 00LOCK 怎么清理?包安装被中断后留下 00LOCK 目录,后续安装会认为该 library 正在被占用。vector memory exhausted limit reached RR vector memory exhausted:向量堆上限问题macOS 或受限环境中的 R 可能先撞到向量堆上限,即使系统仍显示剩余内存。C stack usage is too close to the limit RR C stack usage is too close to the limit递归函数、循环引用或深层表达式会耗尽 C 调用栈。DESeq2 count matrix non-integer valuesDESeq2 some values in assay are not integersDESeq2 的原始 count assay 必须是非负整数,TPM、FPKM 和小数估计值不能直接输入。DESeq2 model matrix is not full rankDESeq2 model matrix is not full rank 怎么解决?设计公式中的变量完全共线或某些组合没有样本时,模型系数无法唯一估计。every gene contains at least one zero DESeq2DESeq2 every gene contains at least one zero几何均值法在每个基因都含零值时无法估算 size factor。edgeR No residual df dispersionedgeR No residual df:没有残差自由度每个样本都被模型参数完全解释时,edgeR 无法估计离散度。No variable features found Seurat RunPCASeurat No variable features found:PCA 无法运行RunPCA 或 ScaleData 默认依赖 VariableFeatures;未生成或被清空时流程会停止。SCT assay has multiple models with unequal library sizesSeurat SCT assay has multiple models with unequal library sizes合并多个 SCTransform 对象后直接做差异分析,会因 SCT 模型测序深度不一致而报错。Some cell names are duplicated across objects provided SeuratSeurat duplicate cell names:合并对象细胞名重复多个 10x 样本常共享相同 barcode,直接 merge 会自动改名或造成追踪困难。More dimensions specified in dims than have been computed SeuratSeurat requested dimensions larger than computed PCAFindNeighbors、RunUMAP 使用的 dims 超过 PCA 实际生成维度时会失败。Please install skmisc package Scanpy seurat_v3Scanpy ImportError: scikit-misc / loess is not installedScanpy 使用 seurat_v3 高变基因方法时需要可选依赖 scikit-misc。KeyError genes are not in index ScanpyScanpy KeyError: genes are not in var_names绘图或子集时给出的基因名不在 adata.var_names 中。No neighbors found on adata ScanpyScanpy neighbors not found:先运行 pp.neighborsUMAP、Leiden 和 PAGA 都依赖已计算的邻居图。Trying to modify attribute of view initializing view as actualAnnData ImplicitModificationWarning / modifying viewAnnData 子集默认可能返回 view,直接写入会触发隐式复制或产生难以追踪的行为。Unable to synchronously open file h5adread_h5ad Unable to synchronously open fileh5ad 文件损坏、未写完或 HDF5 版本不兼容时,Scanpy/AnnData 无法打开。Cell Ranger could not detect chemistryCell Ranger could not detect chemistryCell Ranger 无法从 reads 结构和 barcode 匹配率判断 10x chemistry。Cell Ranger barcode whitelist mismatchCell Ranger barcode whitelist mismatch / low barcode matchbarcode 与预期 whitelist 匹配率很低时,Cell Ranger 会怀疑 reads 布局或 chemistry 错误。

Linux、Slurm 与系统环境

CUDA out of memoryCUDA out of memory:显存溢出的排查与修复GPU 仍有少量空闲显存,并不代表下一块连续显存一定能成功分配。批次大小、模型缓存和其他进程都会影响结果。No space left on deviceNo space left on device:磁盘明明没满为什么还报错?除了磁盘容量,inode、用户配额和临时目录也可能先耗尽。测序流程的中间文件通常远大于最终结果。Permission denied LinuxLinux Permission denied:逐级检查权限目录可见不代表文件可读写。父目录执行权限、挂载盘 UID/GID 和容器映射都会造成 Permission denied。Segmentation fault core dumpedSegmentation fault / core dumped 的生信排查思路段错误来自底层 C/C++ 程序或扩展。输入损坏、ABI 冲突和内存压力都可能触发。No such file or directoryNo such file or directory:路径存在仍找不到文件?相对路径、大小写、软链接和计算节点挂载差异,是这类报错的主要来源。slurmstepd error Detected oom-kill eventSlurm Detected oom-kill event:作业内存不足Slurm cgroup 检测到作业超过申请内存后,会终止部分或全部进程;退出码不一定直接写成 OOM。CANCELLED DUE TO TIME LIMIT SlurmSlurm CANCELLED DUE TO TIME LIMIT 怎么续跑?作业达到 walltime 后会被调度器终止。盲目把时间改得很长,可能降低排队优先级。Too many open files errno 24Too many open files:并行任务文件句柄耗尽并行读取大量 FASTQ、分片结果或临时文件时,进程可能超过文件描述符上限。error while loading shared libraries cannot open shared object fileerror while loading shared libraries:缺少 .so 文件可执行程序已经安装,但动态链接器找不到它依赖的 .so,常见于环境未激活或 LD_LIBRARY_PATH 被覆盖。permission denied while trying to connect to the Docker daemon socketDocker permission denied /var/run/docker.sock当前账号无权访问 Docker socket,或者 daemon 没有启动。把 socket 改成 777 会扩大主机控制风险。torch.cuda.is_available falsePyTorch CUDA is not available:GPU 不可见PyTorch 返回 CUDA 不可用,可能是安装了 CPU 版本或容器没有获得 GPU。The detected CUDA version mismatches PyTorchPyTorch detected CUDA version mismatch编译扩展使用的本机 CUDA toolkit 与 PyTorch 编译版本不同。command not found LinuxLinux command not found:软件装了却找不到Shell 在 PATH 中找不到要执行的程序。exit code 137 killed processExit code 137 / Killed:进程为什么被杀?退出码 137 通常表示进程收到 SIGKILL,最常见原因是 OOM 或调度器强制终止。Bus error core dumped LinuxBus error core dumped:总线错误排查程序访问无法映射的内存或损坏的 mmap 文件时可能触发 Bus error。bad interpreter No such file or directory bash Mbad interpreter /bin/bash^M:脚本换行符错误Windows CRLF 换行会把解释器识别成 /bin/bash^M。Argument list too long LinuxArgument list too long:文件太多无法展开Shell 通配符展开出的参数总长度超过系统 ARG_MAX。Read-only file system LinuxRead-only file system:目录突然不能写挂载点处于只读状态,任何写入都会失败。Input output error Linux file systemInput/output error:磁盘或网络存储读写失败EIO 表示内核无法完成底层读写,通常不是普通权限问题。Broken pipe errno 32 LinuxBroken pipe:管道中途断开上游仍在写数据,但下游进程已经退出或连接被关闭。Unable to allocate resources Invalid partition name SlurmSlurm Invalid partition name:分区不存在作业请求了集群中不存在或当前不可用的 partition。Invalid account or account partition combination SlurmSlurm Invalid account or account/partition combination提交账号与 partition/QOS 的关联无效,调度器拒绝创建作业。Slurm pending Resources Priority reasonSlurm 作业一直 PD:Resources / Priority 怎么看?PD 不一定是故障;Resources、Priority、Dependency 等 reason 表示尚未满足调度条件。Batch script contains DOS line breaks CRLFsbatch: Batch script contains DOS line breaksSlurm 检测到作业脚本使用 Windows CRLF 换行并拒绝提交。

Python、Conda 与机器学习

Conda UnsatisfiableErrorConda UnsatisfiableError 依赖冲突怎么修?这个错误说明当前渠道、Python 版本和软件依赖无法同时满足。继续在旧环境里强装包,往往会让冲突扩大。ModuleNotFoundError No module namedModuleNotFoundError / No module named 的正确修复方式多数情况下并不是包没安装,而是运行脚本的 Python 和安装包的 Python 不是同一个环境。GLIBC not foundGLIBC_x.x not found:不要直接升级系统 glibc这属于二进制程序与操作系统底层运行库不兼容。直接替换系统 glibc 风险很高,可能让其他服务一起失效。numpy.dtype size changed may indicate binary incompatibilitynumpy.dtype size changed:二进制不兼容怎么修?升级 NumPy 后,pandas、h5py、scipy 或其他 C 扩展仍链接旧 ABI,就会在 import 阶段直接失败。SSL CERTIFICATE_VERIFY_FAILED pip condaSSL CERTIFICATE_VERIFY_FAILED:Conda/Pip 下载失败证书校验失败通常来自系统时间、CA 证书、单位代理或 HTTPS 劫持。关闭 SSL 验证会引入供应链风险。Unable to allocate array MemoryError NumPyPython MemoryError / Unable to allocate NumPy arrayNumPy 创建稠密数组时需要一次性分配连续内存,大矩阵很容易超过 RAM。No matching distribution found for pippip No matching distribution found:找不到可安装版本PyPI 没有与当前 Python、操作系统或 CPU 架构匹配的发行包。pip dependency resolver conflicts installed packagespip dependency resolver does not currently take into accountpip 安装新包后提示已安装包依赖不兼容,环境可能处于半冲突状态。Failed building wheel for pip packagepip Failed building wheel:编译扩展失败没有预编译 wheel 时 pip 会转为源码构建,缺少编译环境就会失败。libGL.so.1 cannot open shared object fileImportError: libGL.so.1 cannot open shared object fileOpenCV、绘图库或可视化依赖找不到系统 OpenGL 运行库。GLIBCXX version not found Python CondaGLIBCXX_x.x not found:libstdc++ 版本冲突Python/R 扩展加载了过旧的 libstdc++,缺少编译时要求的 GLIBCXX 符号。pandas.errors.ParserError Error tokenizing datapandas ParserError:CSV 列数不一致CSV/TSV 某些行的字段数与表头不一致时,read_csv 会停止解析。h5py Unable to open file file signature not foundh5py OSError: Unable to open fileHDF5 文件不存在、被锁定、损坏或根本不是 HDF5 时会打开失败。feature names should match those that were passed during fitscikit-learn feature names mismatch:训练与预测列不一致模型预测时输入列名或顺序与训练阶段不一致。PackagesNotFoundError current channels CondaConda PackagesNotFoundError:当前 channels 找不到包配置的 Conda channels 中没有目标包或指定版本。CondaSSLError SSL verification errorCondaSSLError:HTTPS 证书验证失败Conda 无法验证仓库 HTTPS 证书,常见于代理、系统时间或 CA 链异常。CondaValueError prefix already existsConda prefix already exists:环境目录已存在创建环境时目标名称或路径已经存在,但它可能不是有效 Conda 环境。Jupyter kernel died restartingJupyter Kernel died / restarting:内核反复崩溃Notebook 内核被 OOM、底层扩展崩溃或环境损坏终止。

测序文件、比对与变异分析

BGZF EOF marker is absentBAM 报错 BGZF EOF marker is absent 怎么处理?这个警告常见于 BAM 传输未完成、写入任务被中断或文件被截断;继续分析可能产生不完整结果。samtools truncated file failed to read headersamtools truncated file / failed to read header 修复BAM/CRAM 文件头无法读取或中途截断,多由下载、合并、排序任务异常退出造成。A USER ERROR Fasta dict file for reference does not existGATK sequence dictionary not found:参考基因组字典缺失GATK 需要 FASTA、.fai 和 .dict 三件套,并且文件名前缀及 contig 顺序必须对应。incompatible contigs No overlapping contigs foundGATK incompatible contigs:chr1 与 1 不一致参考基因组、BAM 和 VCF 的染色体命名或参考版本不同,是 GATK 最常见的输入一致性错误之一。STAR EXITING because of FATAL INPUT ERROR could not open readFilesInSTAR EXITING: fatal input ERROR 无法打开 FASTQSTAR 找不到 FASTQ、解压命令错误或文件权限不足时,会在正式比对前退出。sequence and quality have different length FASTQFASTQ sequence and quality length mismatch 怎么修?FASTQ 每条记录的序列长度必须与质量值长度一致;截断传输、错误换行或拼接操作都会破坏结构。featureCounts Unassigned_NoFeaturesfeatureCounts 结果全是 Unassigned_NoFeatures大量 reads 没有分配到基因,常见原因不是“样本没表达”,而是染色体命名、注释版本或链特异参数不一致。gzip unexpected end of filegzip unexpected end of file:压缩文件被截断gzip 在到达合法结束标记前文件就结束,说明内容不完整。gzip invalid compressed data crc errorgzip invalid compressed data / CRC errorgzip 数据校验值不匹配,文件内容在存储或传输过程中发生损坏。BWA fail to locate the index filesBWA fail to locate the index filesBWA 找不到与参考 FASTA 对应的一组索引文件。fewer reads in file specified with -2 than -1 Bowtie2Bowtie2 paired-end files have different number of reads双端 FASTQ 的记录数不一致时 Bowtie2 无法保持配对。samtools index failed unsorted positionssamtools index:BAM 未按坐标排序samtools index 要求 BAM 按参考坐标排序。Chromosome blocks not continuous samtoolssamtools Chromosome blocks not continuous / out of order同一染色体记录被其他染色体块分隔,文件不满足坐标排序要求。the file is not BGZF compressed bcftools indexbcftools index:文件不是 BGZF 压缩普通 gzip 压缩的 VCF 不能直接建立 tabix/CSI 随机访问索引。Contig is not defined in the header VCFVCF contig is not defined in the header记录中的染色体没有对应 ##contig header,严格工具会拒绝处理。GATK read group ID not found sample name missingGATK read groups missing:BAM 缺少 RG/SM许多 GATK 工具要求 BAM reads 具有有效 read group,尤其是 SM 样本字段。GATK java.lang.OutOfMemoryError Java heap spaceGATK Java heap space / OutOfMemoryErrorJava 堆上限不足时,GATK 即使所在节点还有内存也可能 OOM。Error Sorted input specified but file out of order bedtoolsbedtools sorted input:染色体排序不一致使用 -sorted 时,BED/BAM 必须遵循一致的 contig 和坐标顺序。Paired-end reads were detected in single-end read library featureCountsfeatureCounts paired-end reads detected in single-end modeBAM 含成对 reads,但 featureCounts 参数按单端运行,或反之。STAR genome index is incompatible with this versionSTAR genome version is incompatible with genome indexSTAR 可执行版本与现有 GenomeDir 索引格式不兼容。Salmon index version not compatibleSalmon index version is not compatibleSalmon 新旧版本的索引格式可能不兼容,量化时会拒绝加载。

Nextflow、Snakemake 与流程管理