使用Mailchimp Marketing API无法获取列表全部订阅者问题排查

你的代码在循环获取Mailchimp订阅者时仅拿到1001条，核心问题大概率出在分页请求的有效性验证或循环逻辑细节处理上，以下是具体排查和修复方案：

1. 先排查每次请求的实际返回数据量 #

目前你只打印了total_items和offset，但无法确认每一页实际获取的成员数量。在合并数据前添加日志，明确每一页的返回情况：

private function getProductionSubscribers(string $list = 'test'): array
{
    $finalTos = [];
    $count = 1000;
    $offset = 0;
    $totalItems = 0;

    do {
        $tos = $this->getMailchimpListSubscribers($list, $count, $offset);
        
        // 新增：打印当前页获取到的成员数量
        $currentCount = !empty($tos->members) ? count($tos->members) : 0;
        log_message('error', "Offset $offset: fetched $currentCount members");
        
        if ($currentCount > 0) {
            $finalTos = array_merge($finalTos, $tos->members);
        }
        
        // 仅在第一次请求时缓存总数量，避免后续请求的波动影响循环
        if ($totalItems === 0) {
            $totalItems = $tos->total_items;
            log_message('error', "Total subscribed members: $totalItems");
        }
        
        $offset += $count;
        log_message('error', "Updated offset: $offset");
    } while ($offset < $totalItems);

    $callback = fn($member) => [
        "email" => $member->email_address,
        "type" => "to"
    ];
    return array_map($callback, $finalTos);
}

通过这条日志，你能明确：

• 第二页（offset=1000）是否真的返回了1000条数据
• 第三页（offset=2000）是否返回了剩余的651条数据

2. 修复API请求的错误处理 #

你的getMailchimpListSubscribers方法未处理API请求失败的情况，如果某次请求超时或返回错误，$tos可能是不包含members的对象，导致数据漏采。添加异常捕获：

private function getMailchimpListSubscribers(string $list, int $count, int $offset)
{
    try {
        $response = $this->mailchimpMarketing
            ->lists
            ->getListMembersInfo(
                $list,
                null,
                null,
                $count,
                $offset,
                null,
                'subscribed'
            );

        return $response;
    } catch (\Exception $e) {
        log_message('error', "Mailchimp API request failed at offset $offset: " . $e->getMessage());
        // 可根据业务需求选择抛出异常终止，或返回空对象
        throw new \RuntimeException("Failed to fetch subscribers: " . $e->getMessage());
    }
}

3. 避免参数传递错位（PHP 8+） #

虽然你的参数顺序看似符合官方文档，但可以用命名参数避免位置传递错误，确保关键参数被正确赋值：

$response = $this->mailchimpMarketing
    ->lists
    ->getListMembersInfo(
        list_id: $list,
        count: $count,
        offset: $offset,
        status: 'subscribed'
    );

4. 验证循环终止逻辑 #

原代码每次循环都用当前请求的$tos->total_items判断，若列表在请求过程中发生变化（如新增/删除订阅者），可能导致循环提前终止或无限循环。改为用第一次请求获取的固定总数量判断：

// 第一次请求后缓存总数量
if ($totalItems === 0) {
    $totalItems = $tos->total_items;
}
// 后续循环用缓存的总数量判断终止条件
} while ($offset < $totalItems);

额外排查方向 #

• 如果某一页返回0条数据，可直接调用Mailchimp API测试工具，手动请求GET /lists/{list_id}/members?count=1000&offset=2000&status=subscribed，确认返回结果。
• 检查你的Mailchimp API密钥是否有足够权限访问该列表的成员数据。
• 确认列表中是否存在大量非订阅状态的用户，status='subscribed'过滤条件是否正确。

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