使用C#调用Google Sheets API v4追加数据时触发空引用异常

我之前做类似的C#项目时也碰到过这个Object reference not set to an instance of an object异常，结合Google Sheets API v4的常见踩坑点，给你几个具体的排查方向和解决办法：

1. 检查SheetsService实例是否正确初始化 #

空引用最常见的原因就是你的SheetsService对象是null，这通常是授权流程出了问题。要确保你完成了完整的授权步骤，并且成功创建了Service实例：

UserCredential credential;
var credentialsPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "credentials.json");
using (var stream = new FileStream(credentialsPath, FileMode.Open, FileAccess.Read))
{
    string tokenPath = "token.json";
    credential = GoogleWebAuthorizationBroker.AuthorizeAsync(
        GoogleClientSecrets.FromStream(stream).Secrets,
        Scopes,
        "user",
        CancellationToken.None,
        new FileDataStore(tokenPath, true)).Result;
}

// 这里一定要确认service不是null
var service = new SheetsService(new BaseClientService.Initializer()
{
    HttpClientInitializer = credential,
    ApplicationName = ApplicationName,
});

调试时可以加个断点，看看service是否被成功实例化——如果是null，大概率是credentials.json路径错误，或者授权过程中出现了未捕获的异常（比如网络问题、凭证无效）。

2. 确保AppendValuesRequest的所有参数都已正确赋值 #

如果service没问题，那就要检查你构造的追加请求对象：

• 确认spreadsheetId是有效的表格ID（不是null或空字符串）
• 确认ValueRange.Values已经被正确初始化，不能为null
• 确认目标Range格式正确（比如"Sheet1!A:C"，且对应工作表存在）

正确的请求构造示例：

// 要追加的数据，必须是二维列表格式
var values = new List<IList<object>>
{
    new List<object> { "2024-05-20", "订单123", 199.99 }
};

var valueRange = new ValueRange
{
    Values = values // 这里绝对不能漏，否则会导致空引用
};

var appendRequest = service.Spreadsheets.Values.Append(valueRange, "你的表格ID", "Sheet1!A:C");
appendRequest.ValueInputOption = SpreadsheetsResource.ValuesResource.AppendRequest.ValueInputOptionEnum.RAW;

// 执行前先检查appendRequest是否为null
if (appendRequest != null)
{
    var response = appendRequest.Execute();
}

3. 避免同步阻塞异步授权流程 #

很多人在Main方法里用.Result阻塞异步授权调用，这可能导致死锁或者授权失败，进而让service变成null。如果你的项目是C# 7.1及以上版本，建议改用异步Main方法：

static async Task Main(string[] args)
{
    UserCredential credential;
    using (var stream = new FileStream("credentials.json", FileMode.Open, FileAccess.Read))
    {
        credential = await GoogleWebAuthorizationBroker.AuthorizeAsync(
            GoogleClientSecrets.FromStream(stream).Secrets,
            Scopes,
            "user",
            CancellationToken.None,
            new FileDataStore("token.json", true));
    }

    var service = new SheetsService(new BaseClientService.Initializer()
    {
        HttpClientInitializer = credential,
        ApplicationName = ApplicationName,
    });

    // 异步执行追加请求
    var appendRequest = service.Spreadsheets.Values.Append(valueRange, spreadsheetId, range);
    appendRequest.ValueInputOption = SpreadsheetsResource.ValuesResource.AppendRequest.ValueInputOptionEnum.RAW;
    var response = await appendRequest.ExecuteAsync();
}

4. 调试时定位具体的null对象 #

最后，最直接的方法是在request.Execute()这一行加断点，然后查看request、service、valueRange这些对象哪个是null——找到null对象后，就能反向定位到对应的初始化代码哪里出了问题。

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