故障排除¶
常见问题¶
配对代码不显示或不起作用¶
在下列情况下，可能无法显示或打印 配对代码 ：
物联网系统未连接到网络。
物联网系统已连接到 Odoo 数据库。请 将其与数据库断开连接。
该 配对代码 的显示时间已过期。请重启 物联网盒子 或 Windows 虚拟物联网服务，以生成并显示配对代码。
物联网系统未连接到数据库¶
物联网系统在连接数据库时可能需要几分钟才能重新启动。如果几分钟后仍未出现：
验证物联网系统是否可以访问数据库，服务器是否使用了多数据库环境。
重启 物联网盒子 或 Windows 虚拟物联网服务。
物联网系统已连接到 Odoo 数据库但无法访问¶
请检查物联网系统与运行 Odoo 数据库的计算机是否连接到同一网络，必要时 更新 DNS 设置。
无法从其他设备访问 Windows 虚拟物联网的主页¶
确保该设备与 Windows 虚拟物联网连接到同一网络。
检查 Windows 防火墙配置。
Odoo 升级后物联网系统无法正常工作¶
重启 物联网盒子 或 Windows 虚拟物联网服务。
如果问题仍然存在，请通过刷写物联网盒子的卡片来 更新其镜像，或 卸载 Windows 虚拟物联网程序 并 重新安装虚拟物联网包。
使用 IP 地址可以访问物联网系统的主页，但不能访问 xxx.odoo-iot.com URL¶
请联系您的系统或网络管理员解决问题。网络相关问题不属于 Odoo 支持服务的范围。
如果路由器允许手动 DNS 配置，请将设置更新为使用 Google DNS。
如果路由器不支持此功能，则需要直接更新与物联网系统交互的每个设备上的 DNS 设置，以使用 Google DNS。有关在各设备上配置 DNS 的说明，可在各制造商的网站上找到。
注解
一些物联网设备（如支付终端）可能不需要更改 DNS，因为它们通常都预先配置了自定义 DNS 设置。
在某些浏览器上，会显示提及 DNS 的错误代码（如
DNS_PROBE_FINISHED_NXDOMAIN）。
物联网系统已连接，但报告被分配给了无法打印的打印机¶
请检查浏览器是否被允许 访问本地网络上的设备。
HTTPS 证书生成问题和错误¶
HTTPS 证书不会生成¶
潜在原因包括以下几点：
错误¶
如果在 HTTPS 证书 的生成或接收过程中出现任何问题，物联网系统主页上会显示特定的错误代码。
小技巧
访问物联网系统主页时，它会自动检查是否有 HTTPS 证书，如果没有，会尝试生成一个。如果出现错误，请刷新页面查看问题是否已解决。
缺少凭证¶
物联网中缺少合同和/或数据库 UUID。
请确认这两个值均已正确配置。要更新它们，请 访问物联网盒子主页 或 Windows 虚拟物联网主页，点击 (齿轮) 按钮，然后点击 凭证。
注解
要访问包含错误信息的完整请求异常详细信息，请 启用开发者模式，在物联网应用程序中点击物联网系统的卡片，然后在 物联网系统的表单 中点击 下载日志。要定义记录在物联网系统日志文件中的日志级别，请 访问物联网盒子的主页 或 Windows 虚拟物联网的 主页，点击 （齿轮）按钮，然后点击页面底部的 日志级别。
要解决与网络相关的问题，请联系您的系统或网络管理员；这些问题超出了 Odoo 支持服务的范围。
无法访问 Odoo.com¶
物联网系统成功访问了 https://www.odoo.com，但收到了异常的 HTTP 响应（状态码）。
解决问题：
在浏览器中打开 https://www.odoo.com，查看网站是否因维护而暂时关闭。
- 如果 https://www.odoo.com 因维护而停机，请等待其恢复。如果网站可以运行，请打开 支持票据，并确保在工单中包含 3 位 HTTPS 状态代码。
仍然没有证书？¶
如果物联网系统已成功连接到 https://www.odoo.com，但服务器拒绝提供 HTTPS 证书。
检查物联网系统和数据库是否符合 HTTPS 证书的 资格要求 。
授予 Odoo 支持团队访问物联网盒子的权限¶
如果您需要授予对物联网盒子的远程访问权限，可以在物联网盒子主页上提供一个 Tailscale 令牌。这样 Odoo 支持团队即可安全地访问物联网盒子进行故障排除。
警告
请仅输入来自可信来源（例如 Odoo 官方支持代表）的令牌。提供令牌会授予对物联网盒子及您整个本地网络的访问权限，因此应谨慎操作。
在 物联网盒子主页 上，点击 (齿轮) 按钮，然后点击 调试工具。在弹出的窗口中，输入 Odoo 支持团队提供的 Tailscale 令牌，然后点击 启用。
注解
Remote Debug 仅适用于 物联网盒子，不适用于 Windows 虚拟物联网。
物联网盒子是否宕机？¶
如果物联网盒子已宕机，您仍可为 Odoo 支持团队启用远程访问。只需在 主页 上显示的唯一字段中提供密钥，然后点击 启用。
注解
仅 v26.01.2026 以上版本支持在宕机的物联网盒子上启用远程访问。如果您的物联网盒子没有此选项，则需要 使用最新镜像刷写物联网盒子的卡片。