---
title: 报告Bug
description: 从管理控制台直接向NexCMP团队提交Bug工单：表单说明、具体发送与绝不发送的数据、配额限制以及常见错误解决方法。
url: https://nexcmp.com/zh-cn/docs/administration/report-a-bug/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 报告Bug {#report-a-bug}

> **管理后台位置：**Top bar › **Report a bug**（位于Docs旁；仅主管理员可见）。

发现NexCMP中的缺陷？点击**Report a bug**，描述问题并发送即可。报告会一步直达NexCMP团队并作为工单关联到您的许可证账户——无需登录其他任何平台，也无需手动复制日志文件。所有方案均可使用：NexCMP Free提供Bug修复，NexCMP Source同样支持。

::: info Bug报告并非技术支持请求
NexCMP Free不包含技术支持，因此请仅将此表单用于软件本身的缺陷。安装配置协助与迁移支持属于[NexCMP Source](https://nexcmp.com/pricing)范畴。
:::

## 前提条件 {#requirements}

| 项目 | 前置条件 |
|---|---|
| 版本 | NexCMP 1.5.2或更高版本 |
| 发送权限 | 主管理员账户。员工账户（只读）、代理商控制台、客户及只读演示环境均无法发送 |
| 许可证 | 处于激活状态且未被暂停的许可证（Free或Source） |
| 网络 | 服务器必须能够通过HTTPS访问`https://nexcmp.com`（与许可证检查及更新所使用的地址相同） |

## 提交报告 {#send-a-report}

1. 点击顶部栏中的**Report a bug**。在手机端，打开菜单并选择**Report a bug**。
2. 输入简短的**Subject**。
3. 在**What happened**下方，描述您的操作、实际看到的现象以及预期结果。
4. 可选填写**Steps to reproduce**。
5. 选择**Impact**：**Blocking**（无法继续工作）、**Major**（主要功能故障）或**Minor**（轻微或界面瑕疵问题）。
6. 保持开启**Attach diagnostics**（推荐），并查看**What will be sent**区域。
7. 点击**Send report**。

在1.6.1中，表单主体可滚动，而操作按钮始终保持可见（包括在手机上）。`password:`或`password=`后面的密码值会被脱敏，且不会移除报告的其余内容。发送前请检查您的文本，并隐去客户数据与凭据。

![包含标题、描述、影响程度以及将发送内容列表的Report a bug对话框](https://nexcmp.com/zh-cn/docs/images/administration/report-a-bug-01-dialog.webp)

报告成功提交后，对话框将显示工单编号及链接。如果团队回复，邮件将发送至您在nexcmp.com许可证账户的邮箱地址；此外，当您作为许可证所有者登录该网站时，工单也会显示在**Support**下方。

## 发送的内容 {#what-is-sent}

点击发送前，**What will be sent**区域会精确显示以下内容：

| 发送项目 | 详细信息 |
|---|---|
| 您输入的文本 | 标题、描述、步骤及影响程度 |
| 版本、方案、域名 | 您的NexCMP版本、方案（Free或Source）以及安装实例的域名 |
| 当前页面 | 您在管理后台中当前所在的页面，不含`?`或`#`后面的任何内容 |
| 浏览器 | 您浏览器的User-Agent字符串（名称、版本及操作系统），截取前200个字符 |
| 最近错误 | 此浏览器标签页中最近生成的最多5条错误。脚本错误仅包含错误信息；请求失败仅包含请求方法、路径及状态码 |

您可以关闭**Attach diagnostics**；关闭后将仅发送您填写的文本以及版本、方案和域名。

## 绝不发送的内容 {#what-is-never-sent}

- 密码、令牌、Cookie以及API密钥。在发送任何数据之前，您输入的文本或错误信息中任何类似上述内容的数据都会在您的服务器本地脱敏（显示为`***`或`[redacted]`）。
- 请求和响应的内容—失败的请求仅记录方法、路径和状态。
- 您的客户数据（姓名、邮箱、订单、发票）及其IP地址。
- 您的浏览器IP地址以及来自您服务器的任何文件。与每次许可证检查一样，许可证服务器仅会看到您服务器发起连接的IP地址。

工单通过服务器已持有的许可证令牌与您的安装实例绑定，因此版本、域名和安装信息均由服务器设定，无法通过浏览器更改。

## 限制 {#limits}

| 限制 | 值 |
|---|---|
| 主题 | 150个字符 |
| 描述与步骤 | 合计8 KB |
| Reports | 整个安装实例每小时5次，每天20次 |

重复发送同一报告（例如网络错误后）不会创建第二个工单。

## 故障排查 {#troubleshooting}

| 消息 | 原因 | 解决办法 |
|---|---|---|
| 请先激活您的许可证 | 该安装实例没有已激活的许可证 | 打开**License & updates**进行激活，然后重新发送 |
| 无法连接许可证服务器 | 服务器无法连接到`nexcmp.com` | 检查服务器的出站HTTPS和DNS连接，然后再次点击**Send report**—您填写的内容已保留 |
| 来自此安装实例的错误报告过多 | 已达到每小时5次或每天20次的上限 | 请稍后重试；也可将新发现补充到已创建的工单中 |
| 此许可证已被暂停 | 许可证已被暂停或已退款 | 请参阅[许可证与购买](https://nexcmp.com/zh-cn/docs/getting-started/license-and-purchase/) |
| 此安装实例已被吊销 | 该安装实例已在许可证门户中被吊销 | 从**License & updates**重新激活 |
| 无法刷新许可证令牌 | 服务器无法续期其许可证令牌 | 打开**License & updates**，点击**Refresh**，然后重新发送 |
| 没有Report a bug按钮 | 您当前使用的是员工、代理商或客户账户登录，或者处于只读演示环境中 | 请以主管理员身份登录 |

::: tip 关于AI助手与API密钥
管理后台中的助手以及管理员API密钥无法代表您发送错误报告：该按钮需要人员以主管理员身份登录方可使用。
:::