spark 性能分析｜TPS、MSPT 与火焰图排查入门

资源作者：lucko 与 spark 贡献者｜中文整理：方块社
本文依据官方文档独立整理，非官方发布。本站未做游戏运行或性能实测；只链接官方下载，不镜像 JAR。资料核验日期：2026-10-10。具体平台、版本与命令以当前官方资料为准。

服卡了，先看证据再改配置

spark 是面向 Minecraft 服务端、客户端和代理的性能分析工具。它能采样方法执行、查看线程调用树与火焰图，并提供 TPS、MSPT、CPU 和内存等信息，帮助缩小卡顿问题的排查范围。

**它不是装上就自动提速的优化插件。**采样报告需要结合当时玩家活动、插件配置和服务器日志解释；某方法占比高，不等于可以直接断言对应插件有问题。

spark 官方文档中的火焰图界面

来源：spark 官方查看器指南。这是作者文档里的分析界面截图，不是方块社服务器实测数据；色块宽度用于表达对应执行时间占比，不是游戏画质展示。

环境	安装建议
Paper 1.21 或更新	官方说明已内置 spark，一般无需再放插件 JAR
其他支持的插件服务端	从官方页面选择对应平台构建，放入 `plugins` 后完整重启
Fabric / Forge / NeoForge	选与加载器及游戏版本匹配的模组，放入 `mods`
Velocity / BungeeCord	使用各自代理构建，命令前缀也不同

核验到的 Modrinth 新发行条目为 1.10.187 的 Fabric / NeoForge 构建，标注 26.1～26.3 的所列版本。这不意味着同一模组 JAR 能放进所有插件服或旧版本游戏；其他平台与历史游戏版本必须单独选择。

本条目重点讲服主排查路线。运行 Java 版本应同时满足服务端、加载器与实际构建要求，不把整个多平台项目简化成一个统一 Java 下限。

若确需用插件替换 Paper 内置版，官方说明有 -Dpaper.preferSparkPlugin=true 启动参数；请先读 Paper 的性能分析文档，不要为了跟教程照抄而重复安装。

先在问题发生时记录基本指标：

/spark tps
/spark health show

再采样一段有代表性的活动，例如：

/spark profiler start --timeout 60

60 秒只是入门采样时长示例，不是所有问题都能在一分钟内定位。默认完成后会提供报告；也可以检查状态或手动结束：

/spark profiler info
/spark profiler stop

若希望取消采样且不上传结果，官方提供 /spark profiler cancel。需要权限 spark 或相应子权限，例如 spark.profiler。只授权给可信管理员，不应对普通玩家开放全部诊断操作。

代理与客户端的命令不同：BungeeCord 用 /sparkb、Velocity 用 /sparkv，Forge/Fabric 客户端用 /sparkc，不要直接照搬服务端前缀。

常规 20 TPS 节奏下，平均每个 tick 的时间预算是 50 毫秒。MSPT 描述处理每个 tick 的耗时；平均值之外，也要关注高分位和峰值，不能只看到 TPS 20 就认定没有短暂卡顿。

进入查看器后，从对应线程和调用树逐层展开，区分自身耗时与包含子调用的总耗时。主线程休眠可能是健康的空闲，不应把 Thread.sleep 看到的时间简单当成瓶颈。代理、客户端或其他线程模型也不能机械套用主线程服的判断。

默认生成报告可能上传到官方查看器。分享链接前检查服务器、插件、线程或运行环境信息，确认没有不应公开的数据。不要公开配置密钥、数据库密码或完整堆转储。

官方支持：

/spark profiler stop --save-to-file

它将报告保存到配置目录，避免该次默认上传。heapdump 可能占用大量磁盘且含敏感数据，不应当作第一步排查；采样、内存诊断也有运行成本，重要服务器先了解对应命令影响。

软件采用 GPL-3.0-only，重新分发或修改须遵守其许可要求。图标与分析界面图来自官方项目和文档，仅作项目识别与必要说明，版权归相应权利人；软件许可证不自动等于所有网页图片的独立开放许可。本站不宣称获得作者背书，图片只做等比例缩放与压缩。