BTCPay Server Boltcard Factory插件编程NFC卡时崩溃问题解析与修复

问题背景

在使用BTCPay Server 2.1.0版本时，用户报告了一个关于Boltcard Factory插件的严重问题。当尝试通过NFC编程器应用程序写入NTAG 424格式的NFC卡时，插件会抛出致命错误，导致整个插件被禁用，BTCPay Server实例重启。

技术现象分析

从错误日志中可以清晰地看到，问题根源在于一个方法调用失败：

System.MissingMethodException: Method not found: 'System.Threading.Tasks.Task`1<System.String> BTCPayServer.HostedServices.PullPaymentHostedService.CreatePullPayment(System.String, BTCPayServer.Client.Models.CreatePullPaymentRequest)'

这个错误表明插件尝试调用PullPaymentHostedService中的CreatePullPayment方法，但该方法在运行时环境中不存在。这种情况通常发生在：

1. 插件与核心系统版本不兼容
2. API接口发生变更但插件未同步更新
3. 依赖项版本冲突

问题影响

当用户执行以下操作流程时触发崩溃：

1. 在BTCPay Server界面查看Boltcard Factory
2. 使用支持NFC的Android手机扫描二维码
3. 通过Chrome浏览器打开并启动Boltcard NFC Programmer应用
4. 将空白NTAG424卡贴近手机进行编程

崩溃发生后，系统会自动禁用插件并在插件管理器中标记为需要卸载状态，严重影响用户正常使用NFC支付卡功能。

解决方案

开发团队迅速响应并发布了Boltcards Extension插件1.1.11.0版本，该版本主要修复了以下问题：

1. 修正了与PullPaymentHostedService的API调用兼容性问题
2. 确保插件方法与核心系统API保持同步
3. 优化了错误处理机制，避免因单个操作失败导致整个插件崩溃

验证结果

升级到1.1.11.0版本后，用户反馈：

• 可以正常创建NFC支付卡
• 能够查询卡片余额
• 支持擦除卡片数据
• 所有操作均不会导致系统崩溃

技术建议

对于使用BTCPay Server NFC支付卡功能的用户，建议：

1. 定期检查插件更新，保持使用最新版本
2. 在进行重要操作前备份系统数据
3. 使用兼容的NFC硬件设备（如NTAG424芯片）
4. 关注系统日志，及时发现潜在问题

此次问题的快速解决展现了BTCPay Server团队对插件生态系统的良好维护能力，也提醒开发者需要注意API兼容性问题，特别是在依赖核心系统功能时。