故障排除¶

常见问题¶

配对代码不显示或不起作用¶

在下列情况下，可能无法显示或打印配对代码：

物联网系统未连接到网络。
该物联网系统已连接到 Odoo 数据库。将其从数据库断开连接。
配对码的显示时间已过期。请重启 IoT 盒子或 Windows 虚拟 IoT 服务以生成并显示配对码。

物联网系统无法连接到数据库¶

物联网系统在连接数据库时可能需要几分钟才能重新启动。如果几分钟后仍未出现：

验证物联网系统是否可以访问数据库，服务器是否使用了多数据库环境。
重新启动 IoT 盒子或 Windows 虚拟 IoT 服务。

物联网系统已连接到 Odoo 数据库，但无法访问¶

请确认物联网系统与运行 Odoo 数据库的计算机连接在同一网络中，如有必要，请更新 DNS 设置。

无法从其他设备访问 Windows 虚拟物联网的主页¶

请确保该设备与 Windows 虚拟物联网连接在同一网络中。
检查 Windows 防火墙配置。

升级 Odoo 后，物联网系统无法正常工作¶

重新启动 IoT 盒子或 Windows 虚拟 IoT 服务。

如果问题仍然存在，请通过刷写 IoT 盒子的存储卡来更新其镜像，或者卸载 Windows 虚拟 IoT 程序并重新安装虚拟 IoT 软件包。

使用 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 证书正确生成。在这种情况下，请停用防火墙，直到证书成功生成。

注解
某些设备，如内置防火墙的路由器，可能会阻止 HTTPS 证书的生成。

错误¶

如果在生成或接收HTTPS 证书期间出现任何问题，物联网系统的主页上将显示特定的错误代码。

小技巧

访问物联网系统主页时，它会自动检查是否有 HTTPS 证书，如果没有，会尝试生成一个。如果出现错误，请刷新页面查看问题是否已解决。

缺少凭据¶

物联网中缺少合约和/或数据库的 UUID（通用唯一标识符）。

请确认这两个值已正确配置。若要更新它们，请访问 IoT 盒子或 Windows 虚拟 IoT 的主页，点击）按钮，然后点击凭证。

注解

要访问包含错误信息的完整请求异常详细信息，请启用开发者模式，在物联网应用程序中点击物联网系统的卡片，然后在物联网系统的表单中点击下载日志。要定义记录在物联网系统日志文件中的日志级别，请访问物联网盒子的主页或 Windows 虚拟物联网的主页，点击）按钮，然后点击页面底部的日志级别。
要解决与网络相关的问题，请联系您的系统或网络管理员；这些问题超出了 Odoo 支持服务的范围。

无法访问 Odoo.com¶

物联网系统成功访问了`<https://www.odoo.com>`_，但收到了异常的`HTTP 响应（状态码）<https://developer.mozilla.org/en-US/docs/Web/HTTP/Status>`_。

解决问题：

在浏览器中打开 https://www.odoo.com，查看网站是否因维护而暂时关闭。
如果 https://www.odoo.com 因维护而停机，请等待其恢复。

如果网站可以运行，请打开支持票据，并确保在工单中包含 3 位 HTTPS 状态代码。

仍然没有证书？¶

如果物联网系统成功连接到https://www.odoo.com，但服务器拒绝提供HTTPS 证书。

检查物联网系统和数据库是否符合 HTTPS 证书的资格要求。

授予 Odoo 支持团队访问物联网盒的权限¶

如果您需要授予对物联网盒的远程访问权限，可以在物联网盒的主页上提供 Tailscale 令牌。这允许 Odoo 支持团队安全地访问物联网盒进行故障排除。

警告

仅输入来自可信来源的令牌，例如官方 Odoo 支持代表。提供令牌将授予对物联网盒和整个本地网络的访问权限，因此应谨慎操作。

在物联网盒的主页上，点击）按钮，然后点击调试工具。在弹出窗口中，输入 Odoo 支持团队提供的 Tailscale 令牌，然后点击启用。

注解

**远程调试**仅适用于物联网盒，不适用于Windows 虚拟物联网。

物联网盒是否已关闭？¶

如果物联网盒已关闭，您仍然可以为 Odoo 支持团队启用远程访问。只需在主页上显示的唯一字段中提供密钥，然后点击启用。

注解

在已关闭的物联网盒上启用远程访问仅适用于 v26.01.2026 以上版本。如果您的物联网盒没有此选项，则需要使用最新镜像刷新物联网盒的卡。