如何用一个 AlipayClient 查询多个支付宝账户账务明细

结论

同一个 AlipayClient 可以复用，前提是这些支付宝账户都授权给了同一个支付宝开放平台应用。

AlipayClient 保存的是应用级配置，包括：

• app_id
• 应用私钥
• 支付宝公钥或证书
• 网关地址
• 签名算法
• 字符集

查询不同的支付宝账户时，不需要重新创建客户端，也不应修改这些配置。每个账户应单独保存自己的 app_auth_token。调用 alipay.data.bill.accountlog.query 时，把目标账户对应的 app_auth_token 传给 SDK 即可。

两者的作用可以这样理解：

• AlipayClient 表示由哪个开放平台应用发起调用
• app_auth_token 表示本次调用要访问哪个已授权商家账户的数据

如果多个账户使用不同的 app_id，或者没有授权给同一个第三方应用，就不能仅靠切换 app_auth_token 来复用同一个 AlipayClient。此时需要根据不同的应用配置分别创建客户端。

为什么不能通过业务参数直接切换账户

alipay.data.bill.accountlog.query 返回当前授权主体能够访问的商家账户账务明细。账户身份由调用链路中的应用身份和授权令牌共同确定，不能通过普通业务参数随意指定。

因此，以下做法不能用来切换账户：

• 修改查询条件中的支付宝账号
• 传入手机号、登录邮箱等账户信息
• 在多个线程中动态修改 DefaultAlipayClient 的 app_id、私钥或证书
• 把商家 user_id 当作授权凭证

即使接口的业务参数中包含筛选或标识账户的字段，这些字段也不能代替 app_auth_token 所代表的应用授权关系。

推荐的接入方式

1. 使用同一个第三方应用完成商家授权

需要查询的每个支付宝账户，都应授权给同一个应用。授权成功后，应用会取得该账户对应的授权信息。

建议至少保存以下关联关系：

内部账户编号 -> 支付宝商家标识 -> app_auth_token -> 授权状态

如果授权流程还返回了刷新令牌、过期时间等信息，也应一并保存，并按照支付宝开放平台的授权规则更新。具体字段和有效期以当前授权接口文档及实际响应为准。

2. 全局创建一个 AlipayClient

下面的示例使用 Java SDK 的普通公钥模式：

import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;

public final class AlipayClientHolder {

    private static final AlipayClient CLIENT = new DefaultAlipayClient(
        "https://openapi.alipay.com/gateway.do",
        "your_app_id",
        "your_app_private_key",
        "json",
        "UTF-8",
        "alipay_public_key",
        "RSA2"
    );

    private AlipayClientHolder() {
    }

    public static AlipayClient getClient() {
        return CLIENT;
    }
}

这里的 your_app_id、应用私钥和支付宝公钥始终属于同一个开放平台应用。查询不同的支付宝账户时，不要修改这些配置。

如果应用使用证书模式，应根据所用 SDK 版本的证书初始化方式，配置应用公钥证书、支付宝公钥证书和支付宝根证书。证书也是应用级配置，不随商家账户切换。

3. 每次请求传入目标账户的 app_auth_token

下面用通用请求类演示调用方式：

import com.alipay.api.AlipayClient;
import com.alipay.api.AlipayRequest;
import com.alipay.api.AlipayResponse;
import com.alipay.api.request.AlipayDataBillAccountlogQueryRequest;
import com.alipay.api.response.AlipayDataBillAccountlogQueryResponse;

public class AccountLogService {

    private final AlipayClient alipayClient;

    public AccountLogService(AlipayClient alipayClient) {
        this.alipayClient = alipayClient;
    }

    public AlipayDataBillAccountlogQueryResponse query(
            String appAuthToken,
            String bizContent) throws Exception {

        AlipayDataBillAccountlogQueryRequest request =
            new AlipayDataBillAccountlogQueryRequest();

        request.setBizContent(bizContent);

        // appAuthToken 决定本次查询哪个已授权的支付宝商家账户
        return alipayClient.execute(request, appAuthToken);
    }
}

调用时，给不同账户传入各自的令牌：

AlipayClient client = AlipayClientHolder.getClient();
AccountLogService service = new AccountLogService(client);

String accountABizContent = """
{
  "start_time": "2026-09-01 00:00:00",
  "end_time": "2026-09-01 23:59:59",
  "page_no": 1,
  "page_size": 100
}
""";

AlipayDataBillAccountlogQueryResponse responseA =
    service.query("account_a_app_auth_token", accountABizContent);

AlipayDataBillAccountlogQueryResponse responseB =
    service.query("account_b_app_auth_token", accountABizContent);

示例中的查询字段只用于说明请求的组织方式。字段名称、时间格式、分页上限和必填条件以 alipay.data.bill.accountlog.query 当前接口文档为准。

批量拉取多个账户

可以维护账户与令牌的映射，再通过同一个客户端依次查询：

import java.util.Map;

Map<String, String> accountTokens = Map.of(
    "account-a", "account_a_app_auth_token",
    "account-b", "account_b_app_auth_token"
);

for (Map.Entry<String, String> entry : accountTokens.entrySet()) {
    String accountCode = entry.getKey();
    String appAuthToken = entry.getValue();

    AlipayDataBillAccountlogQueryResponse response =
        service.query(appAuthToken, accountABizContent);

    if (response.isSuccess()) {
        System.out.println(accountCode + " 查询成功");
        // 保存该账户的账务明细，并继续处理分页
    } else {
        System.err.printf(
            "%s 查询失败，code=%s，subCode=%s，subMsg=%s%n",
            accountCode,
            response.getCode(),
            response.getSubCode(),
            response.getSubMsg()
        );
    }
}

如果要并发查询，先确认当前支付宝 Java SDK 版本中的客户端实现支持并发使用。即使客户端能够复用，请求对象也要在每次调用时新建，不要让多个线程共享并修改同一个 request。

哪些配置需要切换

无法复用一个客户端的情况

如果当前的接入方式是每个支付宝账户使用各自的应用，那么不同账户会对应不同的：

• app_id
• 应用私钥
• 支付宝公钥或证书配置

这种情况下，应根据 app_id 创建多个 AlipayClient，并通过缓存统一管理，例如：

Map<String, AlipayClient> clientByAppId;

调用时，先根据账户找到对应的 app_id，再取得相应的客户端。不要在已经创建好的 DefaultAlipayClient 上临时替换私钥或 app_id。

注意事项

授权范围必须包含该接口

持有 app_auth_token 并不表示应用可以调用所有接口。应用必须具备 alipay.data.bill.accountlog.query 所要求的产品能力或权限，商家的授权范围也要覆盖该能力。

如果接口返回无权限、授权失效或令牌无效等错误，应检查：

1. 接口能力是否已经开通。
2. 商家是否授权给了当前 app_id。
3. 使用的 app_auth_token 是否属于该应用。
4. 授权是否已被商家取消或已经失效。
5. 请求是否误用了其他环境、应用或账户的令牌。

不要混淆应用令牌和用户授权令牌

这个场景通常使用第三方应用代商家调用时所需的 app_auth_token，不能直接代入其他类型的访问令牌。具体使用哪种授权机制，仍需结合应用类型以及接口文档中的”授权方式”确认。

做好分页和增量同步

账务明细通常需要分页拉取。生产环境可以按照”支付宝账户 + 时间区间”保存同步游标，并妥善处理：

• 多页数据
• 请求失败后的重试
• 重复数据去重
• 时间边界重叠
• 限流和调用频率控制
• 单个账户失败时不影响其他账户

去重键应优先采用接口返回的稳定唯一标识。如果接口没有单一的唯一字段，再根据实际返回字段设计组合键，不要只把查询时间作为唯一依据。

日志中不要输出完整令牌

app_auth_token 是敏感凭证。日志中最多记录账户内部编号、令牌末尾少量字符和支付宝返回的错误码，不要输出完整令牌、应用私钥或原始签名内容。

正确的结构是：一个应用级 AlipayClient 对应多个商家级 app_auth_token，每次请求根据目标支付宝账户选择相应的令牌。只有应用配置本身不同，才需要创建多个 AlipayClient。

备注：内容仅供参考。