stripe webhook签名验证失败最常见的原因是未正确读取原始请求体：flask中必须用request.get_data(as_text=false)一次性获取原始bytes，且仅调用一次；payload不能是dict，endpoint_secret须为dashboard中的webhook signing secret，路由需禁用csrf。
Stripe SDK在Flask中处理Webhook时签名验证失败
Stripe Webhook签名验证失败，最常见的原因是没正确读取原始请求体。Flask默认用request.get_data()会触发多次读取，导致后续request.json为空或报错。
- 必须在验证前用
request.get_data(as_text=False)一次性获取原始字节流，且只调用一次 - 验证函数要用
stripe.Webhook.construct_event(payload, sig_header, endpoint_secret)，其中payload是原始bytes，不是dict - 确保
endpoint_secret是从Stripe Dashboard复制的「Webhook signing secret」，不是publishable key或secret key - Flask路由必须禁用CSRF（如用
@app.route('/webhook', methods=['POST'], csrf=False)），否则某些部署环境（如某些WAF）会拦截
支付宝SDK回调验签总返回False
支付宝公钥验签失败，90%是因为证书格式或编码问题——它不接受PEM头尾（-----BEGIN PUBLIC KEY-----），只要纯base64内容。
- 把支付宝提供的公钥文件用
openssl rsa -pubin -in alipay_public_key.pem -text -noout确认结构，再手动删掉头尾行，只保留中间base64字符串 - 验签时传入的
data必须是原始query string（GET）或body（POST）的完整、未解析、未URL decode的字符串 - 用
alipay.verify(data, sign)前，确保data里字段顺序和支付宝回调原样一致（不能用request.form.to_dict()，会乱序；应拼接key=value并按key字典序排序） - 注意支付宝沙箱环境返回的
sign_type可能是RSA2，SDK初始化时必须显式指定sign_type="RSA2"
支付成功后前端跳转丢失订单状态
用户完成支付后跳回你的页面，但后端查不到对应订单，本质是支付网关异步通知（Webhook）和前端同步跳转不同步，不能依赖跳转参数做状态更新。
- 前端跳转URL（如
return_url）只用于展示结果，所有状态变更必须以Webhook为准 - Webhook收到后，先查
event.data.object.id（Stripe）或out_trade_no（支付宝），再查本地订单是否存在且状态为pending - 更新订单状态后，立刻返回HTTP 200，不要做耗时操作（如发邮件），否则Webhook重试会堆积
- 前端跳转页用轮询或WebSocket监听订单状态变更，而不是靠URL参数判断最终结果
生产环境部署时HTTPS证书导致SDK连接超时
本地测试正常，上线后stripe.Charge.create()或alipay.api_alipay_trade_page_pay()卡住或抛SSLError，大概率是服务器CA证书过期或缺失。
- Python默认用系统CA证书，CentOS/RHEL常自带过期的
ca-bundle.crt，运行curl -v https://api.stripe.com看是否报SSL cert problem - 临时方案：在请求前设
os.environ['SSL_CERT_FILE'] = '/etc/ssl/certs/ca-bundle.crt'（路径依发行版而定） - 长期方案：升级系统证书包（
yum update ca-certificates或apt-get install --reinstall ca-certificates），或改用certifi包：pip install --upgrade certifi，并在代码开头加import certifi; stripe.http_client = stripe.requests.RequestsHttpClient(ca_bundle_path=certifi.where())
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
