1. MaxQuant安装与启动故障：安装失败、环境依赖问题、版本兼容性
各位同仁，开始跑MaxQuant之前，安装这一步就能卡住不少人。我自己这些年帮同事排查安装问题，少说也有二三十次。说白了，大多数故障不是软件本身的问题，而是环境没配好。这一章我把最常见的安装翻车点都拎出来，按场景拆开讲，你对着排查基本能搞定。
1.1 安装环境准备与常见依赖问题
MaxQuant是Windows原生应用，但跑起来依赖几个底层组件。先看看你的机器有没有装全。
必须的运行时依赖
| 组件 | 最低版本 | 作用 |
|---|---|---|
| .NET Framework | 4.7.2 或更高 | UI 及核心算法引擎 |
| Oracle Java JRE | 8u201 以上 | Andromeda 搜索引擎调用 |
| Microsoft Visual C++ Redistributable | 2015–2022 | 底层数值计算库 |
| Windows 操作系统 | 10 1809 / Server 2019 及以上 | 主运行环境 |
我个人习惯装完系统第一件事就补全这三个运行时。别等到MaxQuant报错再去翻日志，那样效率太低。
reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" /v Release返回值 >= 461814 对应 4.7.2。如果低于这个数，去微软官方下载离线安装包。
Java 这边更容易忽略。我记得有一次帮同事排查，MaxQuant能启动但点“Run”就无响应。后来发现他装的是OpenJDK 11，而Andromeda对Oracle JRE的某些API有依赖。换成Oracle JRE 8u202后问题消失。
1.2 安装失败的典型场景
安装过程中最常见的报错，我列了一个速查表，你按症状找解法。
| 错误现象 | 根本原因 | 解决方案 |
|---|---|---|
| 安装程序“正在准备”卡住不动 | Windows Installer 服务未运行或损坏 | 以管理员运行 msiexec /unregister 再 msiexec /regserver |
| “无法找到入口” 对话框 | VC++ 运行库缺失或版本不对 | 安装 Visual C++ Redistributable 2015–2022 x64 |
| 安装后双击无反应 | .NET Framework 版本过低 | 升级到 4.7.2 或 4.8 |
| “Could not load file or assembly” | DLL 文件被防病毒软件隔离 | 将 MaxQuant 安装目录加入杀毒软件白名单 |
| 安装路径含中文或特殊字符 | MaxQuant 内部使用 ANSI 编码解析路径 | 重新安装到纯英文字符的目录，例如 C:\MaxQuant |
我曾经在Windows Server 2016上遇到过最棘手的案例：安装程序走到一半自动回滚，没有任何错误码。折腾了半天，最后发现是系统缺少KB2999226补丁（Universal C Runtime）。打上补丁后再装，一次成功。所以如果是Server系统，先检查系统更新。
Andromeda.exe误判为可疑程序直接删除。我建议你装完后立刻把整个安装目录加白，省得每次启动都弹框。
1.3 版本兼容性问题
MaxQuant每发布一个主版本，通常会增大搜索空间、改进定量算法，但也可能引入新的依赖。版本不匹配经常导致令人抓狂的隐性问题。
MaxQuant 版本与操作系统
- MaxQuant 1.x – 2.0：支持Windows 7 SP1及以上，但在Windows 11上UI缩放可能异常。建议用兼容模式运行。
- MaxQuant 2.1+：明确要求Windows 10 1809以上，不再支持Win7。如果你还在用老系统，老老实实保留一个Win10虚拟机。
搜索引擎版本捆绑
MaxQuant 2.0之后自带的Andromeda引擎与特定版本绑定。举个例子，MaxQuant 2.0.3.0只能配合Andromeda 1.6.0.0，如果你手动替换了Andromeda目录下的jar文件，搜索会输出NaN结果。我刚开始用的时候踩过这个坑，浪费了三天重跑数据。
conf\Andromeda\ 和 lib\Andromeda\ 文件夹里的任何文件。搜索引擎版本必须与 MaxQuant 主程序匹配。
第三方软件兼容
MaxQuant支持多种质谱原始格式（.raw, .d, .wiff等），但依赖对应的API库：
- Thermo .raw：需要安装Xcalibur或MSFileReader。建议用MSFileReader 3.0 SP2。
- Bruker .d：需要Bruker Compass DataAnalysis 4.2+。
- SCIEX .wiff：依赖SCIEX OS或PeakView。注意32位/64位版本要和MaxQuant一致。
我曾经遇到一个项目，所有Thermo .raw文件加载时弹出“MSFileReader未注册”。解决方法很简单：以管理员身份注册一下dll。
regsvr32 "C:\Program Files\Thermo\MSFileReader\MSFileReader.dll"另外，如果你同时安装多个版本的MaxQuant（比如2.0和2.5），注册表里会保留各自的UI设置。启动器可能指向旧版本的数据文件夹，导致“版本不匹配”警告。我的做法是：每个版本独立安装到不同路径，并在环境变量MAXQUANT_HOME里指向当前要用的版本。
MAXQUANT_HOME应该指的位置。
这张图是我自己总结的诊断顺序。从安装失败出发，先检查环境依赖（.NET、VC++、Java），再确认版本兼容性，最后看安装包本身是否完整。每一步都有对应的速查表，按图索骥就能快速定位。
嗯，安装这一关过了，后面跑数据处理才会顺畅。如果你按上面的步骤排查完还是有问题，多半是系统级的权限或服务配置出了问题，这部分我们后面章节再展开。