Laravel + Stripe 调用 subscription()->create() 出现 null 错误分析

基础概念

在 Laravel 中使用 Stripe 进行订阅管理时，subscription()->create() 是一个常见操作，用于为用户创建新的订阅。这个错误表明在调用 create() 方法时遇到了 null 对象问题。

错误原因分析

这个错误通常由以下几种情况引起：

1. 用户模型未正确使用 Billable trait：Laravel 的 Cashier 包需要 Billable trait 来提供订阅功能。
2. Stripe 客户未创建：在创建订阅前，用户必须有一个关联的 Stripe 客户 ID。
3. 环境配置问题：Stripe API 密钥未正确配置。
4. 方法调用链中断：subscription() 方法返回 null，可能是由于前面的操作未正确完成。

解决方案

1. 确保正确使用 Billable trait

use Laravel\Cashier\Billable;

class User extends Authenticatable
{
    use Billable;
}

2. 确保用户有 Stripe 客户 ID

在创建订阅前，确保用户已关联 Stripe 客户：

// 如果用户还没有 Stripe 客户 ID
$user->createAsStripeCustomer();

// 然后创建订阅
$subscription = $user->newSubscription('default', 'price_id')
    ->create($paymentMethod);

3. 检查 Stripe 配置

确保 .env 文件中有正确的 Stripe 配置：

STRIPE_KEY=your_stripe_key
STRIPE_SECRET=your_stripe_secret

4. 完整示例代码

// 获取当前用户
$user = Auth::user();

// 确保用户有 Stripe 客户 ID
if (!$user->stripe_id) {
    $user->createAsStripeCustomer();
}

// 创建订阅
try {
    $subscription = $user->newSubscription('default', 'price_monthly')
        ->create($request->paymentMethod);
    
    return response()->json(['success' => true, 'subscription' => $subscription]);
} catch (\Exception $e) {
    return response()->json(['error' => $e->getMessage()], 500);
}

常见问题排查

1. 检查 $user 是否为 null：确保你有一个有效的用户实例。
2. 验证 price_id：确保你使用的价格 ID 在 Stripe 中确实存在。
3. 检查支付方法：$paymentMethod 必须是一个有效的 Stripe 支付方法 ID。
4. 查看日志：检查 Laravel 日志和 Stripe 仪表板中的错误信息。

最佳实践

1. 在创建订阅前总是检查用户是否有 Stripe 客户 ID
2. 使用 try-catch 捕获和处理异常
3. 在生产环境中实现适当的错误处理
4. 测试时使用 Stripe 的测试模式

应用场景

这种订阅模式适用于：

• SaaS 应用的付费订阅
• 会员制网站
• 定期付费服务
• 数字内容订阅

通过正确处理订阅创建流程，你可以为用户提供无缝的付费体验，同时确保你的应用能够可靠地处理订阅管理。