Windows下将NodeJS应用作为Firefox扩展Native Messaging Host失败求助

一、修复Native Host Manifest的参数错误 #

你在编辑3中的args参数包含多余空格，导致Node无法识别脚本路径，这是报错“无此原生应用”的直接原因。正确的Manifest配置如下：

{
  "name": "org.theiner.vlcconvert",
  "description": "Convert m3u8 into mp4",
  "path": "C:\\Program Files\\nodejs\\node.exe",
  "args": ["D:\\Project Folders\\NodeProjects\\NativeMessagingHost\\index.js"],
  "type": "stdio",
  "allowed_extensions": ["vlcconvert@theiner.org"]
}

注意args中的路径前不能有空格，否则会被当成路径的一部分，导致Node找不到脚本文件。

二、处理Native Messaging的消息协议（核心问题） #

Firefox发送的原生消息并非直接的JSON字符串，而是遵循固定格式：先发送4字节小端序整数表示后续JSON内容的字节长度，再发送JSON数据。你的Node代码直接监听process.stdin.on("data")会把长度前缀和JSON内容混在一起，导致无法正确解析，自然不会生成文件。

正确的Node消息处理代码需要先解析长度前缀，再读取对应长度的内容：

const fs = require('fs');
let buffer = Buffer.alloc(0);

process.stdin.on('data', (chunk) => {
  buffer = Buffer.concat([buffer, chunk]);
  
  // 循环处理所有完整的消息
  while (buffer.length >= 4) {
    // 读取4字节长度前缀（小端序）
    const messageLength = buffer.readUInt32LE(0);
    // 检查是否已收到完整的消息内容
    if (buffer.length >= 4 + messageLength) {
      // 提取并解析JSON内容
      const messageContent = buffer.slice(4, 4 + messageLength).toString('utf8');
      // 写入文件（示例操作）
      fs.writeFileSync('native_message_output.txt', messageContent);
      // 截断缓冲区，处理剩余未解析的数据
      buffer = buffer.slice(4 + messageLength);
    } else {
      // 消息内容不完整，等待下一个数据块
      break;
    }
  }
});

直接运行start index.js时你输入的是纯文本，没有长度前缀，所以能正常工作，但与Firefox通信必须遵循上述协议。

三、验证注册表配置的正确性 #

• 若使用64位Firefox，注册表项需放在HKLM\SOFTWARE\Mozilla\NativeMessagingHosts\org.theiner.vlcconvert（64位节点）；若为32位Firefox，需放在HKLM\SOFTWARE\Wow6432Node\Mozilla\NativeMessagingHosts\org.theiner.vlcconvert
• 注册表默认值必须是Native Host Manifest文件的完整绝对路径，例如D:\Project Folders\NodeProjects\NativeMessagingHost\org.theiner.vlcconvert.json，路径不要加多余引号。

四、调试技巧 #

1. 扩展端调试：监听连接断开事件，获取详细错误信息：

let port = browser.runtime.connectNative("org.theiner.vlcconvert");
port.onDisconnect.addListener(() => {
  console.error('连接断开：', browser.runtime.lastError);
});

2. Node端调试：添加日志输出到文件，查看Firefox发送的原始数据：

const fs = require('fs');
process.stdin.on('data', (chunk) => {
  fs.appendFileSync('debug.log', '收到原始数据（十六进制）：' + chunk.toString('hex') + '\n');
  // 后续处理逻辑...
});

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