Missing readBucketLogging Capability Causes JSON Serialization Error #41
Description
When calling ConnectAsync to start the StorageClient against Backblaze’s API, the following error occurs:
[23:10:28 ERR] Async initialization for Api.Infrastructure.Storage.StorageInitializer failed
Newtonsoft.Json.JsonSerializationException: Error converting value "readBucketLogging" to type 'Bytewizer.Backblaze.Models.Capability'. Path 'allowed.capabilities[15]', line 23, position 25.
---> System.ArgumentException: Requested value 'readBucketLogging' was not found.
It appears that the readBucketLogging capability is missing in the library's enum definition. Consequently, the JSON deserialization fails.
Simple Workaround
Below is a quick workaround to help others who may be encountering the same issue. Please note that this is not the ideal solution, the preferred fix is for the library to add the missing readBucketLogging value.
Step 1: Create a Custom Fallback Converter
public sealed class FallbackEnumConverter : StringEnumConverter
{
public FallbackEnumConverter(NamingStrategy namingStrategy) : base(namingStrategy) { }
public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
{
try
{
return base.ReadJson(reader, objectType, existingValue, serializer);
}
catch (JsonSerializationException)
{
// Returns a default instance if we can’t find a matching enum value
return Activator.CreateInstance(objectType);
}
}
}Step 2: Replace the Default Converter (Example with Unsafe Accessors)
If you’re using .NET 8+, you can leverage UnsafeAccessor to get at the library’s internal fields and properties. Here’s a stripped-down example of how you might do so:
public static class BackblazeWorkaround
{
[UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_client")]
private static extern ref IApiClient GetClient(Storage storage);
[UnsafeAccessor(UnsafeAccessorKind.Method, Name = "get_JsonSerializer")]
private static extern JsonSerializer GetJsonSerializer(ApiRest apiRest);
public static void ApplyFallbackEnumConverter(Storage storage)
{
var apiClient = GetClient(storage);
var jsonSerializer = GetJsonSerializer((ApiRest)apiClient);
jsonSerializer.JsonSettings.Converters.RemoveAt(0);
jsonSerializer.JsonSettings.Converters.Add(
new FallbackEnumConverter(new CamelCaseNamingStrategy())
);
}
}