Web Serial 必须 HTTPS：Secure Context 报错与局域网调试解决

在 `http://192.168.x.x` 或纯 HTTP 域名打开串口网页时，`navigator.serial` 常为 `undefined`，控制台提示必须在 **Secure Context**。这是浏览器对硬件 API 的硬性安全策略，不是你代码写错一行那么简单。

### 为什么强制安全上下文

串口可直达 PLC、工控仪、下载口。若明文 HTTP 可被中间人注入脚本，攻击者可能静默刷固件或搅乱产线。因此 Web Serial 仅允许：

1. `https://` 合法证书站点
2. `http://localhost` / `http://127.0.0.1`（本地豁免）

### 开发期临时方案

局域网 HTTP 调试可在 Chrome 打开： `chrome://flags/#unsafely-treat-insecure-origin-as-secure` 填入如 `http://192.168.1.20:3001`，Enable 后重启浏览器。**仅限开发**，不要当生产方案。

### 生产部署

• 全站 HTTPS（Let’s Encrypt / 云厂商证书）。
• 避免混合内容：页面 https 内嵌 http 资源。
• iframe 嵌入还需 `allow="serial"` 与权限策略。

### 对照检查

| 环境 | 预期 | |---|---| | https://www.serialpro.top | 可用 | | http://localhost:3001 | 可用 | | http://局域网IP | 默认不可用 | | 非 Chromium | 无 API |

遇到 Secure Context 报错：先换 HTTPS 或 localhost，再查代码。这是 Web 串口调试上线的第一道门禁。