Odoo IoT 系统常见故障及排除方法
故障排除
配对码未显示或无效
pairing code <iot/connect/pairing-code> 可能在以下情况下未显示或未打印：
- IoT 系统未连接网络。
- IoT 系统已连接到 Odoo 数据库。
Disconnect it from the database <iot/connect/disconnect>。 pairing code <iot/connect/pairing-code>显示时间已过。
重启IoT box <iot/iot-box/restart>或Windows virtual IoT service <iot/windows_iot/restart>以生成并显示配对码。
IoT 系统未连接到数据库
IoT 系统在连接数据库时可能需要几分钟重新启动。若几分钟后仍未出现：
- 验证 IoT 系统能够访问数据库，且服务器未使用多数据库环境。
- 重启
IoT box <iot/iot-box/restart>或Windows virtual IoT service <iot/windows_iot/restart>。
IoT 系统已连接 Odoo 数据库但无法访问
确认 IoT 系统与运行 Odoo 数据库的计算机处于同一网络，并在必要时
update the DNS settings <iot/troubleshooting/dns>。
Windows 虚拟 IoT 的主页无法从其他设备访问
- 确保设备与 Windows 虚拟 IoT 处于同一网络。
- 检查
iot/windows-iot/firewall。
Odoo 升级后 IoT 系统异常
重启 IoT box <iot/iot-box/restart> 或 Windows virtual IoT service <iot/windows_iot/restart>。
如果问题仍然存在，
update its image <iot/updating_iot/image-code>（通过刷写 IoT box 卡片）或
uninstalling the Windows virtual IoT program <iot/windows_iot/uninstall> 并
reinstalling the virtual IoT package <iot/windows-iot/installation>。
IoT 系统的主页可通过 IP 访问但无法使用 [xxx.odoo-iot.com] URL {#iot/troubleshooting/dns}
请联系系统或网络管理员处理此问题。网络相关问题不在 Odoo 支持服务范围内。
- 若路由器支持手动
DNS (Domain Name System)配置，请将设置改为使用 Google DNS。 - 若路由器不支持此功能，需要在每台与 IoT 系统交互的设备上直接设置 Google DNS。各设备的 DNS 配置方法请参考相应厂商的网站。
:::: note ::: title 注意 :::
- 某些 IoT 设备（如支付终端）通常已预设自定义 DNS，可能不需要更改 DNS。
- 在某些浏览器中，会显示包含 DNS 的错误码（如
[DNS_PROBE_FINISHED_NXDOMAIN]）。
::::
HTTPS 证书生成问题及错误 {#iot/troubleshooting/https_certificate}
HTTPS 证书未生成
可能的原因包括：
数据库不符合
eligibility requirements <iot/https_certificate_iot/iot-eligibility>，无法生成HTTPS certificate <iot/connect/https_certificate>。防火墙阻止了 HTTPS 证书的正常生成。此时，请暂时关闭防火墙，直至证书成功生成。
:::: note ::: title 注意 :::
某些设备（如内置防火墙的路由器）可能会阻止 HTTPS 证书生成。
:::
错误
如果在生成或接收 HTTPS certificate <iot/connect/https_certificate> 过程中出现问题，IoT 系统主页会显示特定错误码。
:::: tip ::: title 提示 :::
访问 IoT 系统主页时，它会自动检查 HTTPS 证书并在缺失时尝试生成。若出现错误，刷新页面查看问题是否已解决。
::::
[ERR_IOT_HTTPS_CHECK_NO_SERVER]
服务器配置缺失，即数据库未 connected <../connect> 到 IoT 系统。
[ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION]
读取现有 HTTPS certificate <iot/connect/https_certificate> 时出错。请确认该证书文件可读。
[ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL]
IoT 中缺少合同和/或数据库的 UUID (Universal Unique Identifier)。
请确认两项值已正确配置。要更新它们，access the IoT box's <iot/iot-box/homepage> 或
Windows virtual IoT's homepage <iot/windows-iot/homepage>，点击 fa-cogs（齿轮）按钮，然后点击 Credentials（凭证）。
[ERR_IOT_HTTPS_LOAD_REQUEST_EXCEPTION]
IoT 系统尝试访问 https://www.odoo.com 时出现意外错误，可能由于网络问题，例如：
- IoT 系统没有互联网访问权限。
- 网络限制（如防火墙或 VPN）阻止了与 https://www.odoo.com 的通信。
:::: note ::: title 注意 :::
- 若需查看完整的请求异常细节，
enable the developer mode <developer-mode>，在 IoT 应用中点击 IoT 系统卡片，然后点击 Download logs（下载日志）。 - 若要定义 IoT 系统日志文件记录的日志级别，
access the IoT box's <iot/windows-iot/homepage>或Windows virtual IoT's <iot/iot-box/homepage>首页，点击fa-cogs按钮，然后在页面底部选择 Log level。 - 若要解决网络相关问题，请联系系统或网络管理员；这些问题超出 Odoo 支持服务范围。
::::
[ERR_IOT_HTTPS_LOAD_REQUEST_STATUS]
IoT 系统成功访问 https://www.odoo.com，但收到意外的 HTTP response (status codes)。
该错误码包含 HTTP 状态。例如，[ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404] 表示服务器返回 “页面未找到”。
解决办法：
- 在浏览器中打开 https://www.odoo.com，检查网站是否因维护而暂时不可用。
- 若网站正在维护，请耐心等待；若网站正常运行，请提交 support ticket，并在工单中注明 3 位数的 HTTPS 状态码。
[ERR_IOT_HTTPS_LOAD_REQUEST_NO_RESULT]
IoT 系统成功连接 https://www.odoo.com，但服务器拒绝提供 HTTPS certificate <iot/connect/https_certificate>。
请检查 IoT 系统和数据库是否满足 eligibility requirements <iot/https_certificate_iot/iot-eligibility>，以获取 HTTPS 证书。