Signal-CLI HTTP Daemon处理Emoji消息的注意事项

在使用Signal-CLI的HTTP Daemon功能时，开发者可能会遇到一个常见问题：当尝试通过JSON-RPC接口发送包含Emoji表情的消息时，服务器会返回解析错误。本文将深入分析这一问题的根源，并提供完整的解决方案。

问题现象

当开发者通过HTTP POST请求向Signal-CLI的HTTP Daemon发送包含Emoji的消息时，通常会收到类似以下的错误响应：

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32700,
    "message": "Unexpected end-of-input in VALUE_STRING",
    "data": null
  },
  "id": null
}

根本原因分析

这个问题的根源在于HTTP请求头中的Content-Length值计算错误。具体来说：

1. JavaScript中的字符串长度属性返回的是UTF-16编码的码元(Code Unit)数量，而不是实际的字节数
2. Emoji表情通常由多个UTF-16码元组成(如😊需要2个码元)
3. 当内容以UTF-8编码传输时，Emoji会占用更多字节(通常4个字节)
4. 如果Content-Length设置不正确，服务器会收到不完整的请求体，导致JSON解析失败

解决方案

方案一：省略Content-Length头部

最简单的解决方案是完全省略Content-Length头部，让Node.js的http模块自动计算并添加正确的值：

const options = {
    hostname: 'localhost',
    port: 8080,
    path: '/api/v1/rpc',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json; charset=UTF-8'
        // 不设置Content-Length
    }
};

方案二：精确计算字节长度

如果需要显式设置Content-Length，应该使用TextEncoder准确计算UTF-8编码后的字节数：

const encoder = new TextEncoder();
const bytes = encoder.encode(postData);

const options = {
    hostname: 'localhost',
    port: 8080,
    path: '/api/v1/rpc',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json; charset=UTF-8',
        'Content-Length': bytes.length
    }
};

// 发送时使用Buffer
req.write(bytes);

技术细节扩展

1. 字符编码基础：

   • UTF-16：JavaScript内部使用的编码，每个字符占用2或4字节
   • UTF-8：互联网标准编码，兼容ASCII，变长(1-4字节)

2. Emoji编码特点：

   • 大多数字符：1个UTF-16码元(2字节)
   • Emoji表情：通常需要2个UTF-16码元(4字节)
   • 在UTF-8中，Emoji通常占用4字节

3. HTTP协议要求：

   • Content-Length必须精确反映请求体的字节数
   • 如果值小于实际字节数，服务器会收到截断的数据
   • 如果值大于实际字节数，请求会挂起等待剩余数据

最佳实践建议

1. 对于简单的应用，推荐省略Content-Length让Node.js自动处理
2. 对于需要精确控制的应用，使用TextEncoder计算字节长度
3. 始终确保Content-Type中包含charset=UTF-8
4. 在调试时，可以打印出请求体的实际字节长度进行验证

通过理解这些底层原理和采用正确的解决方案，开发者可以确保Signal-CLI的HTTP Daemon能够正确处理包含Emoji在内的所有Unicode字符的消息发送需求。