Flutter如何接收并处理支付网关发送的POST请求？

首先明确：Flutter客户端本身无法直接接收外网的POST请求，原因是移动端设备处于内网环境（无固定公网IP），支付网关无法直接访问到你的App，且Flutter没有内置公网HTTP服务的能力。生产环境下必须通过后端服务中转，以下是具体实现方案：

一、标准生产级方案：后端服务中转 #

这是最可靠的实现方式，流程如下：

1. 支付网关完成交易后，将POST请求发送到你的公网后端接口
2. 后端验证请求合法性、处理并存储交易数据
3. 后端通过推送通知将结果同步到Flutter App

1. 搭建后端回调接口 #

以Node.js/Express为例，实现一个接收支付回调的接口：

const express = require('express');
const app = express();
app.use(express.json());

// 支付网关回调接口
app.post('/payment-callback', (req, res) => {
  // 第一步：验证网关签名（必须根据网关文档实现，防止伪造请求）
  const isValidSignature = verifyGatewaySignature(req.body, req.headers['x-gateway-signature']);
  if (!isValidSignature) {
    return res.status(403).send('Invalid request signature');
  }

  // 第二步：处理交易数据，存入数据库
  const transaction = req.body;
  saveTransactionToDB(transaction);

  // 第三步：向Flutter App推送交易结果（以FCM为例）
  sendFCMPush(transaction.userId, {
    type: 'payment_success',
    data: transaction
  });

  // 第四步：返回网关要求的响应（通常是200 OK）
  res.status(200).send('Callback processed');
});

app.listen(3000, () => console.log('Backend running on port 3000'));

2. Flutter端接收推送并处理 #

使用Firebase Cloud Messaging（FCM）接收后端推送，解析并存储交易详情：

import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:hive/hive.dart';

class PaymentNotificationHandler {
  final FirebaseMessaging _fcm = FirebaseMessaging.instance;
  final FlutterLocalNotificationsPlugin _localNotifications = FlutterLocalNotificationsPlugin();

  Future<void> init() async {
    // 请求通知权限
    final settings = await _fcm.requestPermission();
    if (settings.authorizationStatus != AuthorizationStatus.authorized) return;

    // 处理前台收到的推送
    FirebaseMessaging.onMessage.listen((RemoteMessage message) {
      if (message.data['type'] == 'payment_success') {
        final transaction = Transaction.fromJson(message.data);
        // 存储到本地数据库（Hive示例）
        _saveTransactionLocally(transaction);
        // 显示本地通知
        _showNotification(message);
      }
    });

    // 处理后台点击通知的场景
    FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
      if (message.data['type'] == 'payment_success') {
        final transaction = Transaction.fromJson(message.data);
        // 跳转到交易详情页
        _navigateToTransactionDetail(transaction);
      }
    });
  }

  void _showNotification(RemoteMessage message) {
    const androidDetails = AndroidNotificationDetails(
      'payment_channel', 'Payment Alerts',
      importance: Importance.max, priority: Priority.high
    );
    const notificationDetails = NotificationDetails(android: androidDetails);
    _localNotifications.show(
      DateTime.now().millisecondsSinceEpoch,
      'Payment Completed',
      'Transaction ID: ${message.data['transactionId']}',
      notificationDetails,
      payload: message.data.toString()
    );
  }

  Future<void> _saveTransactionLocally(Transaction transaction) async {
    final box = await Hive.openBox('transactions');
    await box.put(transaction.id, transaction.toJson());
  }

  void _navigateToTransactionDetail(Transaction transaction) {
    // 这里实现页面跳转逻辑
  }
}

// 交易数据模型
class Transaction {
  final String id;
  final double amount;
  final String status;
  final DateTime timestamp;

  Transaction({required this.id, required this.amount, required this.status, required this.timestamp});

  Map<String, dynamic> toJson() => {
    'id': id,
    'amount': amount,
    'status': status,
    'timestamp': timestamp.toIso8601String()
  };

  factory Transaction.fromJson(Map<String, dynamic> json) => Transaction(
    id: json['id'],
    amount: json['amount'],
    status: json['status'],
    timestamp: DateTime.parse(json['timestamp'])
  );
}

二、开发调试临时方案：Ngrok + 本地HTTP服务 #

如果开发阶段不想搭建正式后端，可以用Ngrok将本地Flutter的HTTP服务暴露到公网（仅用于测试，禁止生产使用）：

1. Flutter端启动本地HTTP服务 #

使用http_server插件实现简单的HTTP服务：

import 'dart:io';
import 'dart:convert';
import 'package:http_server/http_server.dart';

void startLocalCallbackServer() async {
  final server = await HttpServer.bind(InternetAddress.anyIPv4, 8080);
  print('Local callback server running on port 8080');

  await for (var request in server) {
    if (request.method == 'POST' && request.uri.path == '/payment-callback') {
      // 读取请求体
      final body = await utf8.decoder.bind(request).join();
      final transactionData = jsonDecode(body);
      // 处理并存储交易数据
      final transaction = Transaction.fromJson(transactionData);
      await _saveTransactionLocally(transaction);
      // 返回响应
      request.response.statusCode = 200;
      await request.response.close();
    }
  }
}

2. 用Ngrok转发本地端口 #

运行命令：ngrok http 8080，Ngrok会生成一个公网URL（如https://abc123.ngrok.io），将这个URL + /payment-callback作为支付网关的回调地址即可。

注意：Ngrok的URL是临时的，重启后会变化；且移动端App后台被杀时，本地服务会停止，因此仅适合开发调试。

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