# 测试环境生产卡只读模式清理顺序 | 项目 | 内容 | |---|---| | 日期 | 2026-10-29 | | 范围 | 测试环境 | | 对应机制 | 网关只读卡表 `tb_gateway_readonly_card` + 环境变量 `JUNHONG_GATEWAY_READONLY_ENABLED` | ## 背景 为验证卡流量采集与扣减,把生产上"卡住"的卡导入测试环境。这些是真实用户的卡,测试环境只能查询,不能停复机。 - 只读卡表 `tb_gateway_readonly_card`:存放导入卡的 ICCID 与导入设备的 IMEI(`identifier` 唯一索引)。 - 环境变量 `JUNHONG_GATEWAY_READONLY_ENABLED=true` 时,网关每次写操作(停机、复机、限速、实名认证、设备指令)前按请求卡号查表:在表里就本地拦截、不发请求;查流量、卡状态、实名这三类查询不查表、直接放行。 - 查表失败按拦截处理(宁可停复机失败,不放过真卡)。 - 生产不配置该环境变量,代码不查表。 ## 清理顺序(必须按顺序执行) ### 1. 先处理测试环境里的生产卡(保护仍在,安全) - 把表里这些卡在测试环境的 `enable_polling` 设为 `false`,或删除卡及其测试套餐、采集记录、日快照。 - 确认这些卡已不在轮询队列中,也没有待执行的停复机指令。 > 顺序错误的后果:保护撤掉后这些卡仍在测试环境,一旦触发无套餐、套餐用完、套餐到期等停复机,会**真实停掉用户的卡**。 ### 2. 关闭开关并重新部署 - 部署脚本去掉 `JUNHONG_GATEWAY_READONLY_ENABLED`(或设为 `false`),重新部署 API 与 Worker。 - 以 Gitea Actions 部署成功为准确认生效(不要用数据库连接建立时间判断,连接池每 5 分钟会重建连接)。 > 顺序错误的后果:开关开着就删表,查表报"表不存在"按失败处理,测试环境**所有卡**的写操作都会被拦截,直到关闭开关。 ### 3. 删表 - 新建一对迁移:up 执行 `DROP TABLE tb_gateway_readonly_card`,down 重建该表。 - 不修改原建表迁移。 ### 4. 清理代码(可选) - 删除写操作前的查表逻辑与开关配置。开关关闭时这段代码不生效,不删也不影响。 ## 其他说明 - 生产:不配置开关,不查表。若该版本发布到生产,建表迁移会建出空表,不影响功能,后续删表迁移随之执行即可。 - 数据量:几万行(ICCID + 备注),删表瞬间完成,无锁表风险。 - 留痕:拦截记录在日志、停复机记录与审计中,与该表无关,删表不影响已有记录。