Quantus 上线才一个月，新矿工最常见的两个反馈是「矿工跑起来了但收益是零」和「矿工启动几秒就退出」。这两类问题的根因完全不同，前者的排查顺序要从节点往下走，后者只需要看认证和版本。下面按现象分组给出判据和动作，判据全部来自官方文档，时间为 2026 年 10 月 7 日。
先分清三种没收益
第一种是真的没挖到，节点或者矿工有一环没跑起来。
第二种是挖到了但显示为零，通常是用普通 qz 地址去 solo 挖矿。协议强制把挖矿奖励打到虫洞地址，普通地址收不到任何奖励，这是设计如此，不是故障。
第三种是池子侧还没结算。矿池的统计一般在开挖后 10 到 15 分钟才出现，而到账要等到累计份额超过最低支付门槛，Kryptex 是 0.1 QTC，quanpool 是 0.11 QTC。低于门槛时余额挂着不动属正常。
把这三类分开之后，多数「收益为零」的工单其实落在第二类上。
节点没同步完，挖到的都是孤块
这条是官方文档反复强调的。节点在追块过程中不挖矿，链尖必须足够新，max-tip-age 默认 24 小时，并且必须有对等节点，否则 30 秒宽限之后挖矿会自动暂停。
同步没完成就开始挖，算出来的块是孤块，一分钱拿不到。判据很简单：看节点日志，从 Syncing 变成 Idle 才算到位。同步时间从十几分钟到两小时不等，取决于本机性能和网络。链目录在 Linux 下是用户目录里的 .local/share/quantus-node/chains/mainnet，macOS 下在 Library/Application Support/quantus-node/chains/mainnet。
还有一个连带问题要记住：如果节点启动矿工服务器失败，节点会直接退出，不会退回本地 CPU 挖矿。指望它自动降级是没用的。
收款地址类型不对，奖励不会入账
这是最高频的「看着在挖，收益为零」。用普通透明地址 solo 挖矿，奖励不入账。正确做法是用命令行生成虫洞地址，把输出的 Inner Hash 通过 rewards-inner-hash 参数传给节点。
已经有钱包的用户不要另起一套密钥，加 words 参数从同一套 24 词助记词派生，这样收益会直接出现在 App 里。用第三方矿池则宽松得多，普通 qz 地址就能收款。
查收益时用的地址是生成命令输出的 Address 字段，也可以在节点启动日志里找到；链上查询用官方区块浏览器 explorer.quantus.com。
矿工连不上节点：认证与版本
现象是矿工启动后立刻退出，或者连上几秒就断。按下面顺序查。
看节点有没有进入监听状态。节点日志里出现矿工服务器已经在监听，并且打印了认证与 TLS 文件的路径，才算准备好。没等到这一步就启动矿工，必然失败。
看两个认证文件在不在。首次带 miner-listen-port 启动时，节点会在链目录写 miner-auth-token 和 miner-tls-cert-sha256，手动模式下需要自己把路径传给矿工。一键脚本会自动读取，手动操作必须显式传。
看协议版本对不对。节点与矿工必须成对发布，认证通道的协议标识是 quantus-miner/2。版本不匹配的表现是 TLS 握手直接失败，报 no application protocol。老版本节点与矿工不包含认证机制，那就把认证参数去掉只用 node-addr 连接。
还要注意这属于永久性错误：token 或 TLS 指纹填错，矿工会重试，但不会反复重连到成功，必须重新读一次文件。token 从来不写进日志，只能读文件。
池子侧连不上的常见原因
出站 UDP 被拦是最常见的一种。Quantus 走 UDP，家用路由器或者运营商掐掉 UDP 上行时，矿工只会一直重连而不给明确报错。换手机热点验证一次就能定性。
走 QUIC 的池需要证书指纹参数。SRBMiner 连这类池时要加 tls-cert-sha256，指纹抄错会握手失败。走 Stratum 的池没有这个要求。
HiveOS 没有内置 QTC 支持，必须建自定义矿工类型的 Flight Sheet，安装地址指向 SRBMiner 的专用包，算法字段填 quantus。直接在内置矿工列表里找 QTC 会找不到。
日志里最该看的几行
节点日志在链目录下的 network 子目录里，文件名是 quantus-node.log，用 tail 加 f 参数跟。矿工日志在一键脚本的目录下，是 logs/miner.log。节点指标在 http://localhost:9615/metrics，RPC 在 http://localhost:9944，节点在线状态可以在 telemetry.quantus.cat 按节点名搜到。
几个关键词对应几个结论。Verification failed 并且对等节点掉到零，说明节点版本与网络不一致，去 Releases 页面确认当前网络跑的是哪个版本。协议不匹配看 no application protocol。矿工的失败原因字段能看到是找不到答案、被取消还是错误退出，其中被取消多半是节点已经出了新任务。
还有一条容易被忽略：矿工必须每 5 到 15 秒发一次 QUIC 保活，节点设了 60 秒空闲超时。任务流量本身是事件驱动的，安静一轮可能超过 60 秒没有包，不带保活的矿工会被静默踢下线。官方内核每 5 秒发一次，第三方内核如果没实现这一点，长时间跑会间歇断连。
快速自查清单
从下往上过一遍，基本能覆盖九成场景。
- 节点日志是否已经从 Syncing 变成 Idle，且对等节点数不为零
- 收款用的是虫洞地址还是普通地址，solo 必须用虫洞
- 节点启动日志里有没有出现矿工服务器监听与认证文件路径
- miner-auth-token 与 miner-tls-cert-sha256 两个文件是否存在于链目录
- 节点与矿工是否为配套版本，协议标识是否为 quantus-miner/2
- 连的是 QUIC 池还是 Stratum 池，矿工有没有加对应的证书指纹参数
- 出站 UDP 是否被路由器或运营商拦掉
- 是否已经过了池子的统计延迟与最低支付门槛
- Windows 上的杀毒软件有没有把矿工文件删掉
还有一条单独提醒：Windows Defender 几乎一定会在解压时把矿工文件当威胁删除，解压前先把矿工目录加入排除项，只排除具体目录。
本文判据采集于 2026 年 10 月 7 日，来自 Quantus 官方挖矿指南与矿工协议文档。节点与矿工版本更新频繁，报错文案可能随版本变化，以官方 Releases 与当天日志为准。同类问题的处理顺序可以参考站内 PRL 挖矿报错排查。
延伸阅读
- QTC 挖矿收益实测：5090 与 4090 的日净利差多少
- QTC 挖矿软件怎么选：内核、手续费与下载渠道
- Quantus QTC 挖矿教程：QPoW 算法、节点搭建与收益测算
- QTC 币怎么买：上线交易所与入金路径
- QTC 钱包怎么申请：官方 App 与地址备份全流程
