yhlxj/tools/duration-repair

规格 772 / 774 时长检查与修复 SQL 生成

独立 Java 11 程序，只读数据库，不启动 Spring、不执行修复、不修改规格配置。 从真实车票和订单生成 preview.csv 与逐条带旧值条件的 repair.sql。 数据库表、字段缺失或查询失败时会报错停止，不会忽略失败后生成不完整的修复清单。

为什么不只判断 SQL 等号

expiry_time = DATE_ADD(start_time, INTERVAL 12 MONTH) 判断精确的 12 个自然月， 但部分开通入口使用两次当前时间，可能有秒差；正常半年续费累计一年也会满足等号。 程序展示与“开始时间 + 12 个月”的秒差，并读取当前车票用户的关联订单、成功发放车票的记录和补时记录。 订单通过 order_don.relation_id 和 order_don_ticket_record 两种关联查找并去重。

分类规则：

• candidate：规格为 772/774，当前有用户且车票状态为 validity/outside，起止完整、精确一年； 普通购买、非 VIP、无冻结/恢复/保留天数、无补偿/手工补时记录，且只有一笔同规格普通订单。 历史多数量叠加时长不进入候选；有成功发放独立车票记录的多数量订单按单张票处理。
• review：时间在一年附近（误差不超过 60 秒或到期自然日期相同），或存在续费、多笔订单、补时、 冻结等需要核对的情况。不生成更新 SQL，也不自动接受任何秒差。
• skipped：未设置完整起止时间或时长不属于一年附近，例如已经是半年。

候选只是筛查结果，不是误设的绝对证明。历史换票、未记录的手工改期等仍需核对业务记录。 扣减按原到期时间减 6 个自然月，不按 180 天/183 天，也不重算为开始时间加半年。 例如 2024-02-29 → 2025-02-28 扣减后到期为 2024-08-28。 起止时间缺失、冻结保留权益及续费累计时间均不擅自修正。

在 PowerShell 运行

需要 Java 11+、MySQL Connector/J 8 驱动以及目标数据库的查询权限。程序不会自动读取项目生产配置。 数据库应含本项目的 groups_relation、groups_trips、order_don、 order_don_ticket_record、incr_expiry_time_record 表。使用事务表可以获得一致快照。

在项目根目录执行，将主机、库名和用户名替换成目标环境：

$env:DURATION_REPAIR_JDBC_URL = 'jdbc:mysql://数据库主机:3306/数据库名?serverTimezone=Asia/Shanghai&characterEncoding=UTF-8'
$env:DURATION_REPAIR_DB_USER = '数据库查询用户'
$repairDriver = Join-Path $env:USERPROFILE '.m2\repository\mysql\mysql-connector-java\8.0.23\mysql-connector-java-8.0.23.jar'
$repairOutput = Join-Path $env:TEMP ('duration-repair-output-' + (Get-Date -Format 'yyyyMMdd-HHmmss'))
java '-Dfile.encoding=UTF-8' --class-path $repairDriver tools/duration-repair/RepairSkuDuration.java $repairOutput

终端会隐藏输入数据库密码。非交互运行时通过 DURATION_REPAIR_DB_PASSWORD 环境变量提供密码， 不要把密码写进 JDBC URL、源代码或命令行参数。输出目录必须不存在，其父目录必须存在。

先查看 preview.csv 中每条候选的订单和新旧到期时间，再在数据库客户端打开 repair.sql。 SQL 使用车票 ID、当前用户、所属车队/规格、原开始/到期/更新时间和状态作为条件。 每条更新紧跟 ROW_COUNT()，预期为 1；为 0 表示已修复或记录发生变化，需重新检查。 旧到期条件可防止同一清单重复扣减。事务末尾的 COMMIT / ROLLBACK 均注释， 必须在同一连接内按核对结果执行其中一个，不要执行一半后遗留未结束事务。

程序只生成车票修复 SQL。默认规格仍为 12 个月时，另行在后台改为 6 个月， 并核对 days（天数大于 0 时系统优先使用天数），避免新订单继续错误开通。

离线验证

测试不连接数据库，也不加载 JDBC 驱动：

$repairClasses = Join-Path $env:TEMP ('duration-repair-test-' + [guid]::NewGuid().ToString('N'))
New-Item -ItemType Directory -Path $repairClasses | Out-Null
javac -encoding UTF-8 -d $repairClasses tools/duration-repair/RepairSkuDuration.java tools/duration-repair/RepairSkuDurationTest.java
java '-Dfile.encoding=UTF-8' -cp $repairClasses RepairSkuDurationTest