扫码支付 HTTP 超时时间配置变更记录

背景和目标

扫码成功后，支付接口原先复用全局 HTTP 客户端的 5 秒读取超时。在网络响应较慢时，扫码支付可能过早进入“请求超时”。本次增加独立设置项，使管理员可配置扫码支付等待支付接口返回的 HTTP 读取超时。

配置默认值为 30 秒，允许输入 1～100 的整数值。

实施范围

本次覆盖以下 5 个当前可达支付页面：

• MainActivity
• QuotaActivity
• QuotaNoKeyboardActivity
• FreeActivity
• FreeNoKeyboardActivity

明确不修改：

• NewQuotaActivity
• PaymentManager
• 扫码弹框 5/10 秒等待时间
• MQTT 支付 5 秒倒计时
• 全局 HTTP 客户端的 connect、read、write 超时配置

实际修改

配置和网络层

• 新增 QrcodePaymentTimeoutConfig，集中维护默认 30 秒、1～100 秒范围、配置读写和异常值回退。
• 新增 QrcodePaymentHttpClientFactory，基于全局 OkHttp 客户端创建扫码支付专用客户端。
• 专用客户端只覆盖 readTimeout；connectTimeout 和 writeTimeout 继续沿用全局客户端的 5 秒设置。
• RetrofitClient 新增一次性 API 创建入口，不写入全局 Retrofit 缓存，确保下一笔扫码支付读取最新配置。
• RetrofitRequest.orderPayment 保留原三参数方法，并增加显式扫码超时选择参数，以兼容排除范围内的旧调用。

支付页面

5 个覆盖页面在调用支付接口时根据支付类型显式判断是否启用扫码支付专用读取超时。刷卡、人脸及其他非扫码请求继续使用原有全局客户端。

设置页面

• “支付设置”新增“扫码支付超时时间”设置行。
• 默认显示 30秒。
• 点击后弹出整数输入框，允许输入 1～100。
• 空值、0、101 等非法输入不保存，并提示“请输入1～100之间的整数”。
• 保存后立即刷新页面显示，新值从下一笔扫码支付开始生效。

测试

• 新增 QrcodePaymentTimeoutConfigTest，覆盖默认值、边界值和异常值回退。
• 新增 QrcodePaymentHttpClientFactoryTest，验证仅修改读取超时，并保持基础客户端不变。

涉及文件

• 配置与网络：Constants.java、QrcodePaymentTimeoutConfig.java、QrcodePaymentHttpClientFactory.java、RetrofitClient.java、RetrofitRequest.java。
• 设置页：FragmentPayment.java、fragment_payment_layout.xml、InputQrcodePaymentTimeoutPop.java、input_qrcode_payment_timeout_pop_layout.xml、strings.xml。
• 支付页面：MainActivity.java、QuotaActivity.java、QuotaNoKeyboardActivity.java、FreeActivity.java、FreeNoKeyboardActivity.java。
• 单元测试：QrcodePaymentTimeoutConfigTest.java、QrcodePaymentHttpClientFactoryTest.java。

自动验证结果

以下命令均使用 JDK 8 执行，因为项目的 Gradle 6.7.1 / Android Gradle Plugin 4.2.1 与当前默认 JDK 17 不兼容：

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest --no-daemon
JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:compileDebugJavaWithJavac --no-daemon
git diff --check

• app 完整单元测试通过。
• Debug Java 编译通过。
• Git 空白符检查通过。
• NewQuotaActivity 和 PaymentManager 无代码差异。
• 新增文本文件为 UTF-8/ASCII 兼容编码，均无 BOM。

构建期间仍会输出项目既有的 Build Tools 版本、重复权限、过时 API 和第三方 JAR class 版本警告，本次未修改这些既有问题。

人工验收状态

以下项目需要在消费机设备和可控制延迟的支付接口环境中验证：

1. 首次进入支付设置显示 30秒。
2. 输入 1 和 100 可保存，退出重进后仍保留。
3. 空值、0、101 不保存并显示正确提示。
4. 扫码支付接口响应超过 5 秒但小于配置值时不提前超时。
5. 响应超过配置值时继续显示现有“请求超时”。
6. 5 个覆盖页面的扫码支付均使用新配置。
7. 刷卡、人脸、其他 HTTP 请求、扫码弹框和 MQTT 超时行为保持不变。

当前未连接目标设备，也未接入延迟模拟支付服务，因此上述设备端验收尚未执行。

结论

代码已实现“扫码成功后等待支付接口返回”的可配置 HTTP 读取超时：默认 30 秒，设置范围 1～100 秒。修改仅对 5 个当前可达页面的扫码支付生效，未改动 NewQuotaActivity、PaymentManager 及其他超时机制。自动化测试和编译已通过，剩余工作为设备端人工验收。