C#中Shippo追踪FedEx时出现JSON序列化错误

首先，这个Newtonsoft.Json.JsonSerializationException错误的核心原因很明确：Shippo的TrackingStatus枚举类型中没有定义"PRE_TRANSIT"这个值，但FedEx的API返回了这个状态字符串。

关于这是否是FedEx的持续性问题，得分情况来看：

• 大概率不是FedEx的持续性问题：FedEx的跟踪状态值通常是稳定的，但更可能是你的Shippo SDK版本过旧，没有同步支持FedEx新增的PRE_TRANSIT状态。Shippo会定期更新其枚举类型以匹配各大承运商的状态值，如果你的SDK版本停留在较早的版本，就会出现这种不兼容的情况。
• 小概率是临时数据异常：如果这个错误只是偶然出现一次，可能是FedEx的API在某个时段返回了非标准状态值，但这种情况非常罕见，一般不会持续发生。

解决建议 #

1. 更新Shippo SDK到最新版本：这是最直接的解决方案。新版本的SDK通常会包含对承运商新增状态的支持，更新后TrackingStatus枚举应该会包含PRE_TRANSIT值，序列化错误自然会消失。
2. 自定义JSON转换器处理未知枚举值：如果暂时无法更新SDK，可以创建一个自定义的JsonConverter，在序列化/反序列化时处理未知的枚举值，比如将未知值映射到一个默认的Unknown枚举项，或者直接以字符串形式保留状态值。示例代码大致如下：

public class TrackingStatusConverter : JsonConverter<Shippo.ShippoEnums.TrackingStatus>
{
    public override Shippo.ShippoEnums.TrackingStatus ReadJson(JsonReader reader, Type objectType, Shippo.ShippoEnums.TrackingStatus existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        string statusString = reader.Value.ToString();
        if (Enum.TryParse(statusString, out Shippo.ShippoEnums.TrackingStatus status))
        {
            return status;
        }
        // 返回自定义的未知状态，或者根据需求处理
        return Shippo.ShippoEnums.TrackingStatus.Unknown;
    }

    public override void WriteJson(JsonWriter writer, Shippo.ShippoEnums.TrackingStatus value, JsonSerializer serializer)
    {
        writer.WriteValue(value.ToString());
    }
}

然后在反序列化时注册这个转换器，或者在模型的对应属性上添加[JsonConverter(typeof(TrackingStatusConverter))]特性。
3. 临时绕过枚举限制：如果只是临时排查问题，可以将模型中的status字段暂时改为string类型，这样就能接收所有返回的状态值，后续再根据Shippo的更新调整回枚举类型。

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