无法创建工单
当成员无法在你的 Discord 服务器中打开工单时的逐步检查清单。
工单创建故障排查指南
“我点了按钮，但什么都没发生。”
这是 TicketWave 服务器所有者最常收到的支持请求——而且几乎总是由九种原因中的一种造成。本指南会按照 TicketWave 实际检查的顺序逐一排查，这样第一个失败项就是答案。
每次拒绝都会以 ephemeral message 的形式发送——只有点击按钮的成员能看到。请让他们发给你截图；消息里已经写明了原因。
检查清单
是否有可用的分类？
如果分类系统已启用，但没有配置任何分类，工单创建会立即停止。
❌ No categories are available.修复： 在 Settings → Ticket Categories 中至少创建一个分类，或者禁用分类系统。参见 Ticket Categories。
在免费方案中，列表里只有前 3 个分类会被使用。如果你的所有分类都排在这个范围之外，表现就会和没有分类一样。
成员是否已达到其打开上限？
每个成员可同时持有的未关闭工单数量是有限的。
修复： 关闭该成员现有的工单，或者提高 Settings → Ticket System → Ticket Open Limit。使用 -1 表示无限制。
服务器是否已达到全局上限？
整个服务器也有一个限制——免费方案下最多 10 个未关闭工单，高级版则无限制。
修复： 关闭已解决的工单，或者升级。这个问题通常会在繁忙时段突然出现，看起来就像“机器人坏了”。
是否正在冷却中？
消息会明确写出成员何时可以再次尝试。
修复： 在 Settings → Cooldown Durations 中缩短或移除冷却时间。如果启用了 Admin Cooldown Bypass，管理员可以绕过工单冷却。
工单分类是否还存在？
❌ The ticket category is not configured or was deleted.这通常发生在有人删除或重新创建了 Discord 分类之后。
修复： 在 Settings → Ticket System 中设置有效的 Default Ticket Category，或者重新运行 /admin setup。
是否被节假日模式拦截了？
如果启用了 Prevent Ticket Creation 的节假日模式，成员看到的会是你的节假日通知，而不是工单。
修复： 禁用该模块，或者修正时间段。参见 Holiday Mode。
如果你只设置了开始日期，或者只设置了结束日期，拦截不会自动解除。请同时设置两者，或者关闭该模块。
机器人是否拥有正确的权限？
这是昨天还能用、今天突然不能用的服务器里最常见的原因。
TicketWave 在 服务器中 需要这些权限：
| Permission | Why |
|---|---|
| View Channel | To see the panel and the tickets |
| Manage Channels | To create and delete ticket channels |
| Manage Roles | To set the ticket permissions |
| Send Messages | To post the ticket embeds |
| Read Message History | To build transcripts |
以及在 工单分类内 需要这些权限：
| Permission | Why |
|---|---|
| View Channel | To access the category |
| Manage Channels | To create channels in it |
| Send Messages | To post in the new ticket |
| Attach Files | For images and the captcha |
| Read Message History | For transcripts |
运行 /admin setup 并使用 Validate 按钮。它会帮你检查权限，并准确告诉你缺少哪一项。
验证码步骤是否失败了？
如果启用了 Captcha System，成员必须先完成图片验证码，工单才会创建。答错就不会创建工单——而且成员需要再次点击面板。
修复： 这不是故障。如果你的社区经常卡在这里，可以在 Settings → Captcha System 中禁用该模块。参见 Limits, Cooldowns & Captcha。
其他症状
工单打开了，但成员无法发言
这是预期行为。在 ticket steps 仍未完成之前，成员可以查看工单，但不能发送消息。等最后一步回答或跳过后，发送权限才会解锁。
如果某一步始终没有出现，请检查：
- 没有选项的 button step 会被自动跳过
- authentication step 需要高级版
- 带有 category restriction 的步骤只会在该分类中显示
面板按钮完全没有反应
| Cause | Fix |
|---|---|
| 面板是在你更改配置之前发送的 | 使用 /ticket panel 重新发送一个新的面板 |
| 面板链接到了一个已删除的分类 | 在 Embed Creator 中重新关联按钮 |
| 机器人离线 | 检查 /ping 和我们的 support server |
只有部分成员受影响
几乎总是工单分类中，或者某个特定角色上的 permission overwrite。把受影响的成员和正常工作的成员对比一下——差异通常是某个拒绝 View Channel 的角色。
还是卡住了？
加入我们的 support Discord，并附上成员收到的准确错误信息以及你的服务器 ID。这个组合通常能在几分钟内得到回复。
下一步
- Limits, Cooldowns & Captcha（了解每一项检查）
- /admin setup（验证你的权限）
- Reset Server（使用干净的默认设置重新开始）
How is this guide?