Flutter+Firestore+Stripe项目求助：书籍转移、重复购买提示等功能实现

1. 支付成功后同步书籍至用户Mybooks子集合 #

先确认Firestore结构：为每个用户文档创建myBooks子集合，存储已购书籍的核心信息（bookId、title、coverUrl、purchaseDate等），用bookId作为子集合文档ID，避免重复写入。

在Stripe支付成功的回调逻辑中添加以下代码：

final currentUser = FirebaseAuth.instance.currentUser;
if (currentUser == null) return;

// 从支付订单或书籍详情中获取已购书籍信息
final purchasedBookData = {
  'bookId': 'target_book_id',
  'title': '书籍名称',
  'coverUrl': 'https://example.com/cover.jpg',
  'purchaseDate': FieldValue.serverTimestamp(),
};

// 写入用户myBooks子集合
await FirebaseFirestore.instance
    .collection('users')
    .doc(currentUser.uid)
    .collection('myBooks')
    .doc(purchasedBookData['bookId'])
    .set(purchasedBookData, SetOptions(merge: true));

2. 拦截重复购买并提示 #

在用户触发购买操作前，先查询myBooks子集合判断是否已拥有该书籍：

Future<bool> hasPurchasedBook(String bookId) async {
  final user = FirebaseAuth.instance.currentUser;
  if (user == null) return false;

  final bookDoc = await FirebaseFirestore.instance
      .collection('users')
      .doc(user.uid)
      .collection('myBooks')
      .doc(bookId)
      .get();

  return bookDoc.exists;
}

// 购买按钮点击事件示例
onPressed: () async {
  final isOwned = await hasPurchasedBook('target_book_id');
  if (isOwned) {
    showDialog(
      context: context,
      builder: (_) => AlertDialog(
        title: const Text('提示'),
        content: const Text('您已拥有此书！'),
        actions: [
          TextButton(
            onPressed: () => Navigator.pop(context),
            child: const Text('确定'),
          ),
        ],
      ),
    );
    return;
  }
  // 执行Stripe支付流程
  initiateStripePayment();
},

3. Mybooks页已购书籍搜索功能 #

通过维护搜索关键词状态，在客户端过滤myBooks的查询结果：

class MyBooksPage extends StatefulWidget {
  const MyBooksPage({super.key});

  @override
  State<MyBooksPage> createState() => _MyBooksPageState();
}

class _MyBooksPageState extends State<MyBooksPage> {
  final _searchController = TextEditingController();
  String _searchQuery = '';

  @override
  void initState() {
    super.initState();
    _searchController.addListener(() {
      setState(() => _searchQuery = _searchController.text.trim().toLowerCase());
    });
  }

  @override
  Widget build(BuildContext context) {
    final user = FirebaseAuth.instance.currentUser;
    if (user == null) return const Center(child: Text('请先登录'));

    return Column(
      children: [
        TextField(
          controller: _searchController,
          decoration: const InputDecoration(
            hintText: '搜索已购书籍',
            prefixIcon: Icon(Icons.search),
          ),
        ),
        Expanded(
          child: StreamBuilder<QuerySnapshot>(
            stream: FirebaseFirestore.instance
                .collection('users')
                .doc(user.uid)
                .collection('myBooks')
                .snapshots(),
            builder: (context, snapshot) {
              if (snapshot.hasError) return const Text('加载失败');
              if (!snapshot.hasData) return const CircularProgressIndicator();

              // 过滤符合搜索条件的书籍
              final filteredBooks = snapshot.data!.docs.where((doc) {
                final bookTitle = doc['title'].toString().toLowerCase();
                return bookTitle.contains(_searchQuery);
              }).toList();

              return ListView.builder(
                itemCount: filteredBooks.length,
                itemBuilder: (context, index) {
                  final book = filteredBooks[index].data() as Map<String, dynamic>;
                  return ListTile(
                    leading: Image.network(book['coverUrl']),
                    title: Text(book['title']),
                    // 添加书籍预览/阅读逻辑
                  );
                },
              );
            },
          ),
        ),
      ],
    );
  }
}

若需处理大量书籍，可给myBooks集合的title字段创建Firestore复合索引，提升查询效率。

Stripe从测试模式切换至生产模式的配置步骤 #

1. 替换API密钥：登录Stripe后台切换到「生产模式」，复制Publishable key和Secret key，替换项目中测试环境的密钥（前端用publishable key，后端用secret key）。
2. 配置Webhook（如有）：
   • 在Stripe生产后台设置Webhook端点，替换测试环境的URL；
   • 下载生产环境的Webhook签名密钥，更新后端的签名验证逻辑，确保支付事件的真实性。
3. 生产环境测试：使用真实银行卡进行小额测试（测试后可申请退款），Stripe生产环境不支持测试卡，需用真实支付方式验证流程。
4. 合规检查：确保App符合Stripe服务条款，添加隐私政策、用户协议等合规页面，满足当地支付监管要求。
5. 发布前验证：测试支付成功、失败、取消等全流程，确保生产环境下所有逻辑正常运行。

内容的提问来源于stack exchange，提问作者İsmail Ayberk Gün