需启用chrome实验性功能、通过用户点击触发授权、检查站点串口权限、确保https或localhost安全上下文、验证navigator.serial可用性。
如果您在使用谷歌浏览器访问支持 Web Serial API 的网页时，无法与 Arduino、ESP32 或 STM32 等单片机建立串口通信，则可能是由于 Web Serial 功能未启用、权限未授予或运行环境不满足安全要求。以下是开启网页端串口通信并完成单片机联调的具体操作步骤：
一、启用 Chrome 实验性 Web Serial 功能
Web Serial API 在 Chrome 中默认处于禁用状态，需手动启用对应实验性标志，以激活底层接口支持，使 navigator.serial 对象可在网页 JavaScript 中被识别和调用。
1、在 Chrome 地址栏输入 chrome://flags 并回车进入实验性功能页面。
2、在页面顶部搜索框中输入 Web Serial，定位到 “Enable Web Serial API” 选项。
3、点击该选项右侧下拉菜单，选择 Enabled。
4、点击页面右下角的 Relaunch 按钮，重启浏览器使设置生效。
二、通过用户手势触发设备授权
Web Serial API 强制要求所有设备访问必须由明确的用户交互（如点击按钮）发起，禁止网页自动连接。该步骤用于唤起系统级串口设备选择弹窗，并完成首次权限绑定。
1、访问已集成 Web Serial 的调试网页，例如官方示例页 https://webserial.dev 或国内镜像 https://www.itldg.com/web_serial_debug/。
2、点击网页上标有 Connect to serial device、连接串口 或类似文字的按钮。
3、在弹出的设备选择窗口中，确认目标设备名称（如 Arduino Uno、CP2102 USB to UART Bridge Controller 或 CH340），并勾选 Remember this decision for future visits（如需持久化授权）。
4、点击 Connect 完成授权。
三、检查并重置当前网站的串口权限
Chrome 将 Web Serial 权限按域名独立存储。若此前拒绝过授权、清除过浏览数据或更换过设备，该站点的权限可能处于 Blocked 状态，导致 requestPort() 调用直接失败。
1、在当前网页地址栏左侧点击 锁形图标 ?。
2、点击 Site settings 进入权限管理页。
3、向下滚动至 Permissions 区域，找到 Serial ports 项。
4、点击右侧箭头展开设置，将状态设为 Allow；若显示 Blocked，则点击 Reset permissions 后刷新页面。
四、验证并确保安全上下文环境
Web Serial API 仅在安全上下文中可用，这是浏览器强制实施的安全策略，防止恶意网站未经许可访问本地硬件。非安全环境会导致 navigator.serial 为 undefined，授权流程无法启动。
1、确认当前网页 URL 以 https:// 或 http://localhost 开头。
2、若部署在本地开发服务器，请使用 http://localhost:8080 等形式，避免使用 http://127.0.0.1 或文件协议 file://。
3、在开发者工具控制台（F12 → Console）执行：console.log('serial' in navigator)，返回 true 表示环境就绪。
五、安装并使用 Web Serial 浏览器插件（替代方案）
对于不希望修改实验性标志或需快速启动调试的用户，可借助专为 Web Serial 设计的浏览器插件，绕过 flags 设置与页面 HTTPS 限制（插件自身具备权限代理能力）。
1、访问 Chrome 网上应用店，搜索 Web Serial Online。
2、点击 添加至 Chrome 安装插件。
3、安装完成后，点击浏览器右上角 USB 图标启动插件界面。
4、在插件界面中选择已连接的串口设备（如 COM3 或 /dev/ttyUSB0），设置波特率（如 115200），点击 打开串口 即可收发数据。
