如何对依赖有效CustomerId的Stripe相关业务方法进行单元测试

1. 优先做单元测试，解耦Stripe外部依赖 #

你当前的测试强依赖真实Stripe服务响应，本质是没有对Stripe SDK的调用做抽象隔离。你可以把所有和Stripe交互的逻辑封装到自定义接口层，测试时通过Mock框架（如Moq、NSubstitute）模拟Stripe服务的返回结果，完全不需要使用真实的Stripe客户ID，也不会触发真实的Stripe接口调用。
示例实现：

// 抽象Stripe客户服务接口
public interface IStripeCustomerService
{
    Task<Customer> CreateAsync(CustomerCreateOptions options, CancellationToken ct = default);
}

// 单元测试中的Mock写法（以NSubstitute为例）
var mockStripeService = Substitute.For<IStripeCustomerService>();
// 预设返回自定义的测试ID，不需要真实存在
mockStripeService.CreateAsync(Arg.Any<CustomerCreateOptions>())
    .Returns(new Customer { Id = "cus_test_123456" });

你在测试AddCardPaymentMethod这类方法时，只要Mock对应的Stripe支付方法服务，只要你传入的StripeCustomerId符合格式要求，Mock就可以返回成功结果，不会抛出任何Stripe异常。

2. 集成测试使用上下文共享前置逻辑 #

如果你需要编写对接真实Stripe测试环境的集成测试，不要硬编码客户ID，用测试框架的共享上下文能力，统一执行前置初始化逻辑：

• 所有Stripe相关测试共享同一个前置步骤：仅调用一次创建Stripe客户的逻辑，得到有效的测试客户ID
• 所有测试执行完成后统一销毁测试客户，避免Stripe测试环境产生冗余数据

以xUnit的IClassFixture为例：

// 全局共享的Stripe测试上下文
public class StripeTestFixture
{
    public string TestCustomerId { get; private set; }
    public StripeTestFixture()
    {
        // 整个测试类生命周期仅执行一次初始化
        var customerService = new CustomerService();
        var testCustomer = customerService.Create(new CustomerCreateOptions { 
            Email = "test_stripe@test.com" 
        });
        TestCustomerId = testCustomer.Id;
    }
}

// 测试类继承上下文，直接拿到有效ID
public class PaymentServiceTests : IClassFixture<StripeTestFixture>
{
    private readonly string _validStripeCustomerId;
    public PaymentServiceTests(StripeTestFixture fixture)
    {
        _validStripeCustomerId = fixture.TestCustomerId;
    }

    [Fact(DisplayName = "AddCardToAccount should add a reference for a card to the user.")]
    public async Task Test_AddCardToAccount()
    {
        var user = new ApplicationUser
        {
            StripeCustomerId = _validStripeCustomerId
        };
        // 剩余测试逻辑
    }
}

3. 额外优化建议 #

• Stripe测试环境支持固定格式的测试ID，只要ID符合cus_开头的格式规则，部分测试场景下不需要真实创建客户也能返回成功响应
• 测试用的Stripe密钥、固定测试ID不要硬编码在业务代码中，统一放在测试配置文件中管理即可

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