BTCPay Server发票列表过滤功能存在持久化Bug分析

问题概述

在BTCPay Server 1.13.1版本中，发票列表的过滤功能存在一个设计缺陷，导致用户通过特定方式设置的过滤器会被永久保存在浏览器cookie中，无法通过常规界面操作清除。这个bug会影响用户对发票列表的正常浏览体验。

问题重现步骤

1. 创建若干标准发票
2. 创建一个支付请求(Payment Request)
3. 为该支付请求生成关联发票(这些发票会带有与请求关联的Order ID)
4. 在请求列表页面，点击某请求行右侧的"..."菜单并选择"Invoices"
5. 系统会显示仅包含该请求关联发票的过滤列表
6. 此时即使导航到其他页面再返回，过滤器仍然生效且无法通过界面操作清除

技术原理分析

该问题的核心在于系统将搜索条件(SearchTerm)存储在浏览器cookie中，而没有提供清除机制。具体表现为：

1. 当用户通过请求列表的"Invoices"链接访问发票列表时，系统会将搜索条件写入cookie
2. 后续访问发票列表时，系统会优先读取cookie中的搜索条件
3. 界面没有提供清除搜索条件的显式操作入口
4. 搜索条件持久化在cookie中，导致过滤效果长期存在

临时解决方案

目前用户可以通过以下方式临时解决该问题：

1. 登出后重新登录系统
2. 手动编辑URL参数：将焦点放在搜索框，按Enter使参数显示在URL中，然后删除SearchTerm内容并重新加载页面
3. 直接删除浏览器cookie中的SearchTerm字段

影响评估

该问题属于UI/UX类缺陷，主要影响包括：

1. 用户无法直观地清除过滤器
2. 过滤状态持久化可能导致用户误以为某些发票丢失
3. 增加了用户的操作复杂度
4. 降低了系统的可用性和用户体验

建议修复方案

从技术实现角度，建议采取以下改进措施：

1. 在发票列表页面添加明确的"清除搜索"按钮
2. 考虑使用URL参数而非cookie存储临时搜索条件
3. 实现搜索状态的会话级存储而非持久化存储
4. 在UI上明确显示当前应用的过滤条件

总结

这个BTCPay Server的发票列表过滤bug虽然不影响核心支付功能，但会对管理员日常操作造成不便。开发团队应当优先修复这个用户体验问题，同时建议用户暂时使用文中提到的临时解决方案。对于企业级用户，建议关注后续版本更新以获取官方修复。