All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m36s
- 新增 tb_gateway_readonly_card(卡 ICCID / 设备 IMEI)与开关 JUNHONG_GATEWAY_READONLY_ENABLED, 替换环境变量名单 JUNHONG_GATEWAY_READONLY_ICCIDS - 只读资产只放行查卡状态、查实名、查流量、查设备信息、查设备槽位、同步设备状态; 停机、复机、限速、实名认证链接与设备写操作在网关出口本地拦截;查表失败按拦截;不缓存 - 测试环境部署开启只读模式;新增技术方案与清理顺序文档 Change: add-gateway-readonly-prod-import Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
测试环境生产卡只读模式清理顺序
| 项目 | 内容 |
|---|---|
| 日期 | 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 + 备注),删表瞬间完成,无锁表风险。
- 留痕:拦截记录在日志、停复机记录与审计中,与该表无关,删表不影响已有记录。