Android集成Razorpay首点击WebView未初始化问题求助

核心问题分析 #

从报错java.lang.RuntimeException: Package not found: com.google.android.webview和首次点击失效、二次正常的现象来看，问题出在首次触发支付时，系统WebView组件未完成加载/不可用，二次点击时WebView组件已就绪，因此Razorpay SDK能正常初始化WebView完成支付流程。

具体解决方案 #

1. 确保WebView组件在设备上正常可用

现在Android系统的WebView由Google Chrome提供（部分设备使用系统内置WebView），如果设备未安装Chrome或WebView组件被禁用，就会触发该报错：

• 引导用户检查并安装Google Chrome浏览器
• 若用户无法安装Chrome，可在系统设置中启用「Android System WebView」组件

2. 优化Razorpay初始化与触发逻辑

将Razorpay实例的初始化提前到Activity创建阶段，避免点击时才初始化导致的竞争问题，并添加异常重试机制：

public class Delivery_address_details_page extends AppCompatActivity implements PaymentResultListener {
    private Razorpay razorpay;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.your_layout);
        
        // 提前初始化Razorpay实例，绑定监听
        razorpay = new Razorpay(this);
        razorpay.setPaymentResultListener(this);
    }

    // 支付触发方法
    public void initiatePayment(View view) {
        try {
            // 先检查WebView组件是否可用
            if (!isWebViewAvailable()) {
                Toast.makeText(this, "请安装Google Chrome或启用系统WebView", Toast.LENGTH_LONG).show();
                return;
            }

            // 构建支付参数（根据你的业务需求修改）
            JSONObject paymentOptions = new JSONObject();
            paymentOptions.put("name", "你的商户名称");
            paymentOptions.put("description", "订单支付");
            paymentOptions.put("currency", "INR");
            paymentOptions.put("amount", "100"); // 金额单位为最小货币单位，如1卢比=100
            paymentOptions.put("theme.color", "#009688");

            razorpay.open(paymentOptions);
        } catch (Exception e) {
            // 捕获WebView未找到的异常，尝试重新初始化后重试
            if (e.getCause() != null && e.getCause().getMessage().contains("com.google.android.webview")) {
                // 重新初始化实例
                razorpay = new Razorpay(this);
                razorpay.setPaymentResultListener(this);
                // 重试支付
                initiatePayment(view);
            } else {
                Toast.makeText(this, "支付初始化失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
                e.printStackTrace();
            }
        }
    }

    // 检查WebView组件是否存在
    private boolean isWebViewAvailable() {
        try {
            Class.forName("android.webkit.WebView");
            PackageManager pm = getPackageManager();
            pm.getPackageInfo("com.google.android.webview", 0);
            return true;
        } catch (ClassNotFoundException | PackageManager.NameNotFoundException e) {
            return false;
        }
    }

    // 实现PaymentResultListener的回调方法
    @Override
    public void onPaymentSuccess(String s) {
        // 支付成功逻辑
        Toast.makeText(this, "支付成功: " + s, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onPaymentError(int i, String s) {
        // 支付失败逻辑
        Toast.makeText(this, "支付失败: " + s, Toast.LENGTH_SHORT).show();
    }
}

3. 补充必要的权限配置

确保在AndroidManifest.xml中添加WebView和网络相关的权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

4. 升级Razorpay SDK版本

检查你的build.gradle（Module级别）中Razorpay SDK的版本，使用最新稳定版避免旧版本的兼容问题：

dependencies {
    implementation 'com.razorpay:checkout:1.6.30' // 替换为最新版本
}

关键总结 #

• 提前初始化Razorpay实例，避免点击时的初始化延迟与组件加载竞争
• 添加WebView可用性预检查，提前告知用户组件缺失问题
• 针对WebView未找到的异常添加重试逻辑，覆盖首次加载失败的场景
• 确保设备上WebView组件（Chrome/系统WebView）正常安装启用

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