AWS Lambda .NET 序列化库升级导致Base64字符串反序列化问题分析

背景介绍

在AWS Lambda的.NET环境中，Amazon.Lambda.Serialization.SystemTextJson库负责处理Lambda函数输入输出的JSON序列化和反序列化。近期有开发者反馈，在从2.2.0版本升级到2.4.2版本后，原本能够正常工作的Base64字符串到byte[]的反序列化功能出现了异常。

问题现象

当Lambda函数接收包含Base64编码字符串的JSON输入时，新版本会抛出"JSON值无法转换为byte[]"的异常。这种情况常见于处理CloudWatch日志事件的场景，其中awslogs.data字段通常包含Base64编码的压缩日志数据。

技术分析

问题的根源在于2.4.2版本中引入的ByteArrayConverter实现。该转换器设计时仅支持处理JSON数组形式的byte[]表示（如[1,2,3]），而没有考虑到Base64字符串形式的byte[]表示（如"SGVsbG8="）。

System.Text.Json本身具备将Base64字符串自动转换为byte[]的能力，但自定义的ByteArrayConverter覆盖了这一默认行为，导致兼容性问题。

解决方案

AWS团队在2.4.3版本中修复了这个问题，使ByteArrayConverter能够同时处理两种形式的byte[]表示：

1. 数组形式：[1,2,3]
2. Base64字符串形式："SGVsbG8="

对于暂时无法升级的用户，可以采用以下临时解决方案：

1. 修改模型定义，将byte[]改为string类型，手动处理Base64解码

public class AwsLogs
{
    [JsonPropertyName("data")]
    public string Data { get; set; }
}

2. 创建自定义序列化器，移除默认的ByteArrayConverter

class CustomLambdaJsonSerializer : DefaultLambdaJsonSerializer
{
    public CustomLambdaJsonSerializer() : base(CreateCustomizer) { }

    private static void CreateCustomizer(JsonSerializerOptions options)
    {
        var convertersToRemove = options.Converters
            .OfType<ByteArrayConverter>()
            .ToArray();
            
        foreach (var converter in convertersToRemove)
        {
            options.Converters.Remove(converter);
        }
    }
}

最佳实践建议

1. 对于处理CloudWatch日志事件，建议直接使用AWS提供的Amazon.Lambda.CloudWatchLogsEvents包中的预定义类型，它已经正确处理了Base64编码的数据字段。

2. 在自定义类型中使用byte[]属性时，明确指定其预期的JSON表示形式（数组或Base64字符串），可以通过JsonConverter特性来实现更精确的控制。

3. 升级依赖时，特别是序列化相关的库，应该进行充分的测试，因为这类变更往往会影响数据的输入输出。

总结

这个问题展示了序列化库设计中的一个重要考量点：向后兼容性和灵活性的平衡。AWS团队的修复方案既保持了原有功能，又增加了对新格式的支持，体现了良好的API设计原则。对于开发者而言，理解底层序列化机制有助于更快地定位和解决类似问题。