C#调用Gmail API按查询列邮件时提示source参数为空异常

• 技术环境：C#、JavaScript、ClearScript
• 问题现象：为ClearScript JS运行时开发Gmail对接插件，OAuth2认证流程正常，无筛选条件请求收件箱可正常返回数据；添加时间范围筛选条件后请求报错，无法返回匹配的邮件数据。

JavaScript 调用代码 #

attach(".\\Plugin_GMail.dll")
var tuple = Plugin_GMail.GoogleMail.Mail.Mail_Authenticate(REDACTED)
var service = Plugin_GMail.GoogleMail.Mail.Mail_CreateService(tuple.Item1, "mail")
var request = service.Users.Labels.List("me");
var labels = request.Execute().Labels;
var before = new Date(2022,11,31).valueOf();
var after = new Date(2022,0,1).valueOf();
var res = Plugin_GMail.GoogleMail.Mail.Messages_ListByQuery(service, "me", "before:$b after:$a".replace("$b",before).replace("$a",after),true)

C# 端查询方法实现 #

public static string Messages_ListByQuery(GmailService service, string userId, string query, bool debug = false)
{
    if (debug) Debugger.Launch();
    var msgList = new List<Message>();

    var result = new JSONResponse();

    var request = service.Users.Messages.List(userId);
    request.MaxResults = 500;
    request.Q = query;
    request.LabelIds = "INBOX";

    while (true)
    {
        try
        {                   
            var msgs = request.Execute().Messages;
            if (msgs.Count() == 0)
            {
                break;
            }
            msgList.AddRange(msgs);
        }
        catch (Exception e)
        {
            result.Error = e.Message;
            break;
        }
    }
    result.Cargo = msgList;
    return JsonConvert.SerializeObject(result);
}

报错响应内容 #

{"Error":"Value cannot be null.\r\nParameter name: source","Cargo":[],"Crew":null}

这个报错和Gmail API的参数无关，是**.NET运行时抛出的LINQ方法空参数异常**：所有接收IEnumerable<T>类型参数的LINQ扩展方法（包括代码中调用的Count()），如果传入的源集合为null，就会抛出Value cannot be null. Parameter name: source错误，这里的source就是代码中request.Execute().Messages返回的null值。

触发这个问题有两个直接原因：

1. 时间戳单位不符合Gmail API要求
   Gmail搜索语法中before、after参数要求传入秒级Unix时间戳，但JS中Date.valueOf()返回的是毫秒级时间戳，传入毫秒值后Gmail无法匹配到任何对应时间范围的邮件，此时Gmail .NET SDK返回的响应中Messages属性为null（不是空集合）。无筛选条件时接口能返回邮件数据，Messages是有效集合，因此不会触发该异常。
2. C#代码缺少空值判断，且分页逻辑缺失
   代码直接对可能为null的msgs对象调用Count()方法，触发空异常；同时原有循环没有处理SDK返回的NextPageToken分页标识，即使查询正常也只能拉取第一页最多500封邮件，无法拉取全量匹配结果。

具体修复步骤 #

1. 修正JS端时间戳生成逻辑，将毫秒级时间戳转换为秒级：

// 除以1000后取整，得到Gmail要求的秒级时间戳
// 注意：JS Date月份从0开始计数，11代表12月，此处日期值本身写法正确无需调整
var before = Math.floor(new Date(2022,11,31).valueOf() / 1000);
var after = Math.floor(new Date(2022,0,1).valueOf() / 1000);

2. 修正C#端查询方法，增加空值判断、补全分页逻辑：

public static string Messages_ListByQuery(GmailService service, string userId, string query, bool debug = false)
{
    if (debug) Debugger.Launch();
    var msgList = new List<Message>();
    var result = new JSONResponse();
    var request = service.Users.Messages.List(userId);
    request.MaxResults = 500;
    request.Q = query;
    request.LabelIds = "INBOX";

    try
    {
        do
        {
            var response = request.Execute();
            // 先判断Messages是否为null，再做集合操作
            if (response.Messages != null && response.Messages.Any())
            {
                msgList.AddRange(response.Messages);
            }
            // 赋值分页令牌，存在下一页时继续请求
            request.PageToken = response.NextPageToken;
        } while (!string.IsNullOrEmpty(request.PageToken));
    }
    catch (Exception e)
    {
        result.Error = e.Message;
    }
    
    result.Cargo = msgList;
    return JsonConvert.SerializeObject(result);
}

修复后可以先打印拼接完成的query参数，格式应为before:1672416000 after:1640966400这类秒级时间戳格式，和Gmail网页端搜索语法完全一致，可先在网页端搜索框验证该查询条件能返回预期结果，再调用接口即可正常拉取数据。

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