Chrome扩展含Native Messaging权限但chrome.runtime.connectNative未定义求助

这个问题我之前帮不少开发者排查过，核心原因其实是Chrome扩展的上下文权限隔离——你在内容脚本（inject.js）里直接调用chrome.runtime.connectNative是行不通的，因为这个API根本不在内容脚本的可用API列表里。

Chrome扩展的不同运行上下文拥有严格的API访问边界：

• 后台脚本（Service Worker/Background Page）、Popup、选项页：属于扩展自身的私有上下文，拥有完整的chrome.runtime API权限，包括connectNative，nativeMessaging权限也是作用于这个层级。
• 内容脚本（也就是你的inject.js）：运行在目标网页的上下文里，Chrome为了安全和隔离性，只开放了chrome.runtime的一小部分API（比如sendMessage、onMessage），但**connectNative这类涉及原生系统交互的API是完全禁止直接调用的**。哪怕你在manifest里配置了权限，内容脚本也享受不到这个权限的红利。

核心思路是：让拥有权限的后台脚本去处理Native Messaging的连接和交互，内容脚本通过Chrome的消息传递API和后台脚本通信，间接完成和原生应用的交互。

1. 在后台脚本中实现Native Messaging逻辑 #

比如创建background.js，把原生交互的逻辑放在这里：

// background.js
let nativePort = null;

// 监听来自内容脚本的指令
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  switch(message.type) {
    case 'CONNECT_NATIVE':
      // 连接你的原生应用（替换成你实际的原生应用ID）
      nativePort = chrome.runtime.connectNative('com.your.native.app.id');
      
      // 监听原生应用发来的消息，转发给内容脚本
      nativePort.onMessage.addListener((nativeMsg) => {
        chrome.tabs.sendMessage(sender.tab.id, {
          type: 'NATIVE_MSG_RECEIVED',
          data: nativeMsg
        });
      });

      // 监听连接断开事件，通知内容脚本
      nativePort.onDisconnect.addListener(() => {
        chrome.tabs.sendMessage(sender.tab.id, {type: 'NATIVE_DISCONNECTED'});
        nativePort = null;
      });
      sendResponse({status: 'connected'});
      break;
    case 'SEND_TO_NATIVE':
      if (nativePort) {
        nativePort.postMessage(message.data);
        sendResponse({status: 'message_sent'});
      } else {
        sendResponse({status: 'error', reason: '未连接原生应用'});
      }
      break;
  }
  return true; // 保持消息通道开放，支持异步响应
});

2. 修改内容脚本，通过消息和后台交互 #

调整你的inject.js，不再直接调用connectNative，而是通过chrome.runtime.sendMessage和后台通信：

// inject.js
// 请求后台连接原生应用
chrome.runtime.sendMessage({type: 'CONNECT_NATIVE'}, (res) => {
  console.log('原生连接状态:', res.status);
});

// 封装发送消息到原生应用的函数
function sendToNative(data) {
  chrome.runtime.sendMessage({
    type: 'SEND_TO_NATIVE',
    data: data
  }, (res) => {
    console.log('消息发送结果:', res);
  });
}

// 监听后台转发的原生消息
chrome.runtime.onMessage.addListener((message) => {
  if (message.type === 'NATIVE_MSG_RECEIVED') {
    console.log('收到原生消息:', message.data);
    // 在这里处理原生返回的数据
  } else if (message.type === 'NATIVE_DISCONNECTED') {
    console.log('与原生应用的连接已断开');
  }
});

3. 确保manifest配置正确 #

除了nativeMessaging权限，还要正确注册后台脚本和内容脚本：

{
  "manifest_version": 3,
  "name": "你的扩展名称",
  "version": "1.0",
  "permissions": ["nativeMessaging", "tabs"],
  "background": {
    "service_worker": "background.js"
  },
  "content_scripts": [
    {
      "matches": ["<all_urls>"], // 根据你的需求调整匹配规则
      "js": ["inject.js"]
    }
  ]
}

如果是Manifest V2，后台配置改为"background": {"scripts": ["background.js"]}即可。

• 原生应用的manifest文件必须放在Chrome指定的系统目录下，并且和扩展ID、原生应用ID匹配，否则后台脚本也无法连接成功。
• 修改代码后，一定要在Chrome扩展管理页重新加载扩展，并且刷新目标网页让内容脚本重新注入。

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