如何修复 OctoPrint 中无效 API 密钥和未授权错误

你需要准备

• 可以访问 OctoPrint 自身设置页面中的 API 部分
• 已经在 Printer Tools 中添加好的 OctoPrint 打印机
• 如果密钥丢失或已更改，需要几分钟时间来重新生成

修复 API 密钥错误

1. 1

   重新复制当前密钥

   打开 OctoPrint 的设置，进入 API 部分，按照显示的内容准确复制全局 API 密钥，不要带多余的空格。

2. 2

   在 Printer Tools 中替换密钥

   在 Printer Tools 中打开打印机设置，粘贴刚复制的密钥，替换掉之前的内容。

3. 3

   重新连接并测试

   重新连接打印机。如果仪表盘能够加载，说明问题就在密钥上。如果仍然失败，请确认你是从 Printer Tools 所指向的同一个 OctoPrint 实例复制的密钥。

4. 4

   如有需要，重新生成密钥

   如果密钥丢失，或者你怀疑它已经泄露，请从 OctoPrint 的设置中重新生成，并更新每一个使用它的客户端，包括 Printer Tools。

5. 5

   单独检查串口问题

   如果密钥被接受，但打印机仍然显示为未连接，请查看 OctoPrint 自身的连接面板是否存在串口断开的情况，而不是继续排查 API 密钥问题。

OctoPrint API 密钥设置

Printer Tools 中的 API 密钥字段必须与 OctoPrint 自身设置中当前显示的全局密钥一致。

Printer Tools 如何处理这种情况

• 当 API 密钥本身被拒绝时，显示明确的无效或未授权状态
• 当 OctoPrint 与打印机没有活跃连接时，显示单独的串口断开状态
• 重新连接时无需从头移除并重新添加打印机

不会自动完成的事

• Printer Tools 无法自行生成或修复 OctoPrint API 密钥
• 串口连接问题必须从 OctoPrint 自身的连接设置中修复
• 不支持按用户单独设置的 API 密钥，只有唯一的全局密钥可用

常见的 API 密钥错误

常见问题