ChromeOS托管设备无交互授予Web Serial API串口权限问题咨询

一、核对Google Admin控制台权限配置细节 #

• 确认在设备 > Chrome > 设置 > 用户与浏览器和托管访客会话中，已正确添加Web Serial API的授权规则：
  • 填入应用的完整精确域名（包含https://前缀，比如https://your-kiosk-app.com）
  • 准确填写串口设备的十六进制厂商ID（Vendor ID）和产品ID（Product ID），格式为0xXXXX，不可遗漏前缀或写错数值
• 检查策略项SerialAllowDevicesForUrls（针对指定设备）或SerialAllowAllDevicesForUrls（针对所有设备）是否已包含你的站点，确保策略未被其他配置覆盖

二、确认Kiosk模式的会话类型 #

• 确保ChromeBox运行在托管访客会话的Kiosk模式下，普通用户会话无法自动触发Web Serial的预授权
• 在Admin控制台的设备 > Chrome > Kiosk设置中，确认已启用“允许Web Serial API自动访问授权设备”的相关开关（不同版本控制台可能命名略有差异）

三、代码层面调整（无需用户交互触发） #

• 移除依赖用户点击等交互的逻辑，直接在页面加载阶段调用navigator.serial.getPorts()获取预授权设备：

async function initSerialConnection() {
  // 获取已授权的串口设备列表
  const authorizedPorts = await navigator.serial.getPorts();
  
  if (authorizedPorts.length > 0) {
    const targetPort = authorizedPorts[0];
    // 打开串口（根据设备需求调整波特率）
    await targetPort.open({ baudRate: 9600 });
    
    // 初始化读写逻辑
    const reader = targetPort.readable.getReader();
    const writer = targetPort.writable.getWriter();
    
    // 示例：读取串口数据
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      // 处理读取到的数据
      console.log(new TextDecoder().decode(value));
    }
  }
}

// 页面加载完成后自动执行
window.addEventListener('DOMContentLoaded', initSerialConnection);

四、排查常见生效问题 #

• 强制同步策略：修改Admin配置后，重启ChromeBox或在Chrome地址栏输入chrome://policy，确认SerialAllowDevicesForUrls等策略已同步到设备
• 检查串口占用：确保目标串口未被系统进程或其他应用占用，Kiosk模式下需保证设备独占串口
• 查看调试日志：通过chrome://serial-internals页面查看串口授权状态、连接日志，排查授权失败的具体原因

内容的提问来源于stack exchange，提问作者Raymond Rogers