Navigator.bluetooth不存在：远程连接属性缺失原因及修复方案

为什么远程/IP访问时Navigator缺失Bluetooth属性？ #

Web Bluetooth API属于浏览器的安全上下文受限API，这类API涉及设备硬件访问，浏览器只会在「安全上下文」环境下才会暴露它们。

浏览器默认把localhost、127.0.0.1这类本地回环地址认定为安全上下文，所以你用localhost访问时能正常调用API；但直接用局域网IP（比如192.168.x.x）访问的话，不属于浏览器认可的安全上下文范畴，因此会隐藏navigator.bluetooth这类敏感属性，导致你报错Cannot read properties of undefined (reading 'requestDevice')。

修复方法 #

1. 部署HTTPS（推荐生产/正式测试环境） #

这是最标准的解决方案，所有HTTPS站点都会被浏览器视为安全上下文，不管用IP还是域名访问，都能正常使用Web Bluetooth API。

如果是本地测试，可以用mkcert工具生成信任的自签名证书，避免浏览器出现安全警告。具体步骤：

• 安装mkcert：brew install mkcert（Mac）或下载对应系统的二进制文件
• 生成本地CA：mkcert -install
• 为你的IP生成证书：mkcert 192.168.1.100 localhost 127.0.0.1（替换成你的实际IP）
• 用证书启动你的HTTP服务器（比如Node.js、Nginx等配置SSL证书）

2. 给浏览器添加强制安全上下文例外（仅本地测试用，不建议生产） #

如果暂时不想搞HTTPS，可以通过浏览器启动参数强制把你的IP站点标记为安全上下文：

• Chrome/Edge：关闭所有浏览器窗口，然后在快捷方式或终端里启动浏览器时添加参数：

  chrome.exe --unsafely-treat-insecure-origin-as-secure="http://192.168.1.100:8080"
  

  把http://192.168.1.100:8080替换成你的实际访问地址，启动后就能正常调用Web Bluetooth API了。
• Firefox：在地址栏输入about:config，搜索并修改以下配置：
  • dom.security.https_only_mode设为false
  • privacy.resistFingerprinting设为false
    这种方式风险较高，测试完成后建议改回默认配置。

内容的提问来源于stack exchange，提问作者Guy Levi