Poco JSON序列化时抛出“无法转换为Poco::UTF16String”异常的问题排查

针对你遇到的这个异常，我来拆解一下可能的成因和对应的解决办法：

可能的成因 #

• 非UTF-8兼容字符存在：Poco的JSON序列化逻辑默认基于UTF-8编码，如果Policy对象中包含无效的UTF-8字节序列，或是其他编码（比如GBK、GB2312）的字符未转换为UTF-8，在stringify内部执行UTF-8到UTF-16的转换时就会抛出这个错误。
• 无效的Policy对象：如果jsonObject->getObject("Policy")返回空指针，或是"Policy"字段实际不是JSON对象类型（比如是字符串、数组），后续调用stringify时，内部编码转换环节也可能触发这个异常（错误信息指向编码，但根源是对象无效）。
• 特殊类型JSON值：如果Policy对象中包含Poco JSON库无法正确处理的自定义类型，或是未序列化的二进制数据，在转换为字符串时也会出现编码转换失败的情况。

对应的解决方法 #

1. 确保输入JSON是合法UTF-8编码 #

• 先用Poco自带的工具验证原始JSON数据的UTF-8合法性：

  #include <Poco/UTF8String.h>
  
  // 假设rawJson是原始JSON字符串
  if (!Poco::UTF8::isValid(rawJson)) {
      // 处理无效UTF-8的情况，比如转码或清理数据
  }
  

• 如果原始数据是其他编码（比如GBK），先将其转换为UTF-8再交给Poco解析：

  // 示例：GBK转UTF-8
  std::string gbkData = "...";
  std::string utf8Data = Poco::TextConverter(Poco::GBKEncoding(), Poco::UTF8Encoding()).convert(gbkData);
  

2. 校验Policy对象的有效性 #

• 在调用stringify前，先检查对象是否为空、字段类型是否正确：

  if (jsonObject->has("Policy") && jsonObject->isObject("Policy")) {
      Poco::JSON::Object::Ptr JsonObject = jsonObject->getObject("Policy");
      if (JsonObject) {
          JsonObject->stringify(stream);
      } else {
          // 处理空对象，比如输出默认空JSON
          stream << "{}";
      }
  } else {
      // 处理"Policy"字段不存在或类型错误的情况
      stream << "{}"; // 或抛出自定义异常
  }
  

3. 处理特殊值或自定义类型 #

• 如果Policy中有特殊字符，存入JSON对象前先做转义处理，确保所有字符都是合法UTF-8。
• 如果是自定义类型，需要为其实现Poco JSON支持的序列化逻辑，或是在存入JSON对象时转换为Poco原生支持的类型（比如字符串、数值、标准容器等）。

4. 调整stringify的调用方式 #

• 尝试用toString()先获取UTF-8字符串，再写入流，绕过内部可能的UTF-16转换环节：

  std::string jsonStr = JsonObject->toString();
  stream << jsonStr;
  

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