c# - "async"/"await"方法中的参数验证应该被包装

Question

为什么 SonarQube 会在这段代码中提示？我阅读了解释，但并不真正理解为什么以及我需要做什么才能让它消失。

Link to SonarQube Rule

public async Task Add(SomeModel obj)
{
    if (obj == null)
    {
        throw new ArgumentNullException(nameof(obj));
    }
    var obj2 = new OtherObject();
    obj2.UpdateWith(obj);
    await _localDatabaseService.AddAsync(obj2);
}

将代码改成这样并不能解决问题。

public Task Add(SomeModel obj)
{
    if (obj == null)
    {
        throw new ArgumentNullException(nameof(obj));
    }
    return AddInternal(obj);
}
private async Task AddInternal(SomeModel obj)
{
    var obj2 = new OtherObject();
    obj2.UpdateWith(obj);
    await _localDatabaseService.AddAsync(i);
}

Answer 1

我刚刚尝试了您的示例，您的第二个代码没有出现问题(将 AddAsync(i) 替换为 AddAsync(obj2) 以匹配第一个代码逻辑。

关于规则的解释，我认为网站已经很清楚了，但让我提供一个代码示例来尝试说明错误的行为。

static async void Main(string[] args)
{
    var x = new Program().Add(null); // Exception is not raised here...

    // do some other things

    await x; // ... but here when awaited
}

如您所见，问题并没有在您预期的时候出现。

显然，如果您确定您永远不会遇到这种情况并且没有人会以这种方式使用您的方法，您可以关闭规则。