Laravel集成Stripe遇‘Undefined type Stripe\Stripe’错误，如何解决？

问题原因分析 #

出现该错误通常源于两个核心问题：Stripe依赖包未正确安装，或代码存在语法、命名空间引用错误。

修复步骤 #

1. 确认Stripe依赖已正确安装 #

执行composer require stripe/stripe-php后，检查项目根目录下的vendor/stripe文件夹是否存在。若不存在：

• 执行composer install重新安装所有依赖
• 或执行composer update stripe/stripe-php单独更新Stripe包，确保依赖拉取完整

2. 修正控制器代码错误 #

你的代码存在两处问题，修正后即可解决类型未定义的报错：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Session;
use Stripe\Stripe; // 引入Stripe类

class StripeController extends Controller
{
    public function checkout() {
        // 补全env()的闭合括号，使用引入后的类名（无需前置反斜杠）
        Stripe::setApiKey(env("STRIPE_PRIVATE_KEY"));
    }
}

3. 优化密钥获取方式（推荐） #

避免直接在业务代码中使用env()函数，建议通过配置文件统一管理：

• 打开config/services.php，添加Stripe配置：

return [
    // 其他服务配置...
    'stripe' => [
        'secret' => env('STRIPE_PRIVATE_KEY'),
    ],
];

• 控制器中改用config()函数读取密钥：

Stripe::setApiKey(config('services.stripe.secret'));

这种方式在生产环境缓存配置后依然能正常读取密钥，避免配置失效问题。

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