Refit配置自定义JsonConverter后序列化未生效问题求助

1. 安装独立的Newtonsoft序列化扩展包 #

Refit 6.x及以上版本默认使用System.Text.Json作为默认序列化器，NewtonsoftJsonContentSerializer属于独立扩展组件，必须单独安装对应NuGet包：

Install-Package Refit.Newtonsoft.Json

未安装该包时，你配置的Newtonsoft序列化规则会被直接忽略，走默认的System.Text.Json逻辑，自然不会触发自定义转换器。

2. 校验InvariantConverter的CanConvert逻辑 #

必须保证转换器的CanConvert方法能正确匹配你要序列化的目标类型，常见两种场景的写法参考：

• 场景1：转换器用于所有string/int类型属性，自动包装为iv嵌套结构

public override bool CanConvert(Type objectType)
{
    return objectType == typeof(string) || objectType == typeof(int) || objectType == typeof(long);
}

• 场景2：转换器仅用于包含Id、Name的特定外层实体类

public override bool CanConvert(Type objectType)
{
    return objectType == typeof(你的实体类名);
}

如果CanConvert返回false，序列化过程不会触发你的转换逻辑。

3. 检查Refit接口的Body参数配置 #

确保你调用的接口方法中，[Body]特性没有指定表单序列化方式，必须使用Json序列化：

// 正确写法，默认走Json序列化
[Post("/你的接口路径")]
Task<返回类型> 你的方法名([Body] 你的实体类 参数名);

// 错误写法，会走UrlEncoded表单序列化，完全忽略Json配置
// [Post("/你的接口路径")]
// Task<返回类型> 你的方法名([Body(BodySerializationMethod.UrlEncoded)] 你的实体类 参数名);

4. 排查服务注册覆盖问题 #

确认后续代码中没有再次注册同一个ICustomerRefitClient且未传入你配置好的refitSettings，后注册的服务会覆盖之前的配置，导致序列化规则丢失。

5. 断点验证转换器执行 #

在InvariantConverter的WriteJson方法首行打断点，发起请求时验证断点是否命中：

• 命中：转换器已正常加载，问题出在转换逻辑本身，调整序列化代码即可实现预期结构
• 未命中：回到上述步骤逐一排查配置问题。

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