ArduinoJson库解析单引号转义字符的问题与修复

问题背景

在JSON格式规范中，字符串值应当使用双引号(")包裹，但在实际应用中，部分系统如HomeAssistant和ESPHome会使用单引号(')作为字符串分隔符。这种非标准的JSON格式给解析带来了挑战。

问题现象

当使用ArduinoJson库解析包含转义单引号的JSON字符串时，会出现解析失败的情况。例如以下JSON字符串：

{ 'summary': 'a\'b' }

按照预期，解析后应得到字符串值"a'b"，但实际却返回解析错误(InvalidInput)。而使用标准双引号格式的JSON字符串则能正常解析：

{ "summary": "a\"b" }

技术分析

这个问题源于ArduinoJson库对单引号字符串中转义字符的处理逻辑不够完善。在JSON标准中，虽然单引号不是官方推荐的字符串分隔符，但很多实际系统为了简化开发会采用这种写法。

当遇到字符串中的转义单引号时，解析器需要：

1. 识别字符串边界（单引号）
2. 正确处理转义字符（反斜杠）
3. 将转义后的字符作为普通字符处理

解决方案

ArduinoJson库在7.2.0版本中修复了这个问题，主要改进包括：

1. 增强了对单引号字符串的解析能力
2. 完善了转义字符的处理逻辑
3. 保持了对非标准JSON格式的兼容性

修复后，以下两种格式都能正确解析：

{"summary": "a\\'b"}  // 标准格式，反斜杠被转义
{'summary': 'a\'b'}   // 非标准格式，单引号被转义

实际应用建议

虽然ArduinoJson现在能够处理这种非标准格式，但在实际开发中仍建议：

1. 尽量遵循JSON标准规范，使用双引号
2. 如果必须处理单引号格式，确保转义字符使用正确
3. 更新到最新版ArduinoJson以获得最佳兼容性

总结

ArduinoJson 7.2.0的这次更新体现了开源库对实际应用场景的灵活适应能力。它不仅解决了特定场景下的解析问题，也保持了对标准JSON格式的兼容性，为物联网和智能家居领域的开发者提供了更好的开发体验。