如何让C#编译器识别AutoMapper的Map方法可能返回null？

因为AutoMapper的T IMapper.Map<T>(object)方法受历史原因影响未适配可空引用类型，传入null会返回null但编译器不会发出警告，以下是几种无需复杂包装接口的解决方案：

1. 使用外部注解文件修改编译器推断 #

通过外部注解为第三方程序集的类型添加空值标记，让编译器将该方法视为T? IMapper.Map<T>(object?)：

• 在项目中创建AutoMapper.NullableAnnotations.xml文件，内容如下：

<assembly name="AutoMapper">
  <type name="AutoMapper.IMapper">
    <method name="Map``1">
      <parameter name="source" attribute="System.Diagnostics.CodeAnalysis.AllowNullAttribute" />
      <return attribute="System.Diagnostics.CodeAnalysis.MaybeNullAttribute" />
    </method>
  </type>
</assembly>

• 配置项目：将该文件的「生成操作」设为「None」，「复制到输出目录」设为「如果较新则复制」；然后在项目的.csproj文件中添加：

<ItemGroup>
  <NullableAnnotationsFile Include="AutoMapper.NullableAnnotations.xml" />
</ItemGroup>

配置完成后，编译器会自动识别该方法的可空性，对可能的空值返回发出警告。

2. 编写轻量扩展方法 #

封装一个适配可空引用类型的扩展方法，替代原Map方法调用：

using System.Diagnostics.CodeAnalysis;
using AutoMapper;

public static class MapperNullableExtensions
{
    [return: MaybeNull]
    public static T? MapNullable<T>(this IMapper mapper, [AllowNull] object source)
    {
        return mapper.Map<T>(source);
    }
}

后续调用时使用mapper.MapNullable<T>(source)，编译器会正确处理空值推断并给出相应警告。

3. 简化版接口包装（可选） #

如果偏好通过接口注入的方式，可编写极简的包装接口和实现：

using System.Diagnostics.CodeAnalysis;

public interface INullSafeMapper
{
    [return: MaybeNull]
    T? Map<T>([AllowNull] object source);
}

public class NullSafeMapper : INullSafeMapper
{
    private readonly IMapper _mapper;

    public NullSafeMapper(IMapper mapper)
    {
        _mapper = mapper;
    }

    [return: MaybeNull]
    public T? Map<T>([AllowNull] object source)
    {
        return _mapper.Map<T>(source);
    }
}

然后在DI容器中注册INullSafeMapper替代原IMapper即可。

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