时间问题处理

This commit is contained in:
lu7213 committed 2026-11-02 02:20:47 -05:00
1 parent 41190a25ae
commit d910c1afe8
66 files changed
+604 -393

No files matched your search

+1 -1
View File
@@ -51,7 +51,7 @@
node -e "console.log(require('node:crypto').randomBytes(32).toString('base64'))"
```
UTC字段使用 `LocalDateTime` 显式按UTC写入,不改变支付业务的LOCAL JDBC连接时区。租赁HTTP响应把BIGINT和USDT转为字符串,防止浏览器浮点数丢精度;时间输出UTC ISO8601,响应设置 `Cache-Control: no-store`。
租赁 `DATETIME(3)` 使用服务器/JVM本地时间,MySQL连接会话同步采用LOCAL,说明见[时间修复与部署](../timezone-fix.md)。本次不处理历史数据,不需要迁移确认开关。租赁HTTP响应把BIGINT和USDT转为字符串,防止浏览器浮点数丢精度;时间仍输出UTC ISO8601真实时间点,响应设置 `Cache-Control: no-store`。
## 3. 首次开通流程
+3 -3
View File
@@ -20,7 +20,7 @@
- `id` 为表内主键;业务编号和唯一键另行承担幂等职责。
- `version` 用于 CAS 乐观锁,更新时带原版本条件并递增;追加记录保持 0。
- `created_at / updated_at` 为应用显式写入的 UTC `DATETIME(3)`。
- `created_at / updated_at` 为应用显式写入的服务器/JVM本地 `DATETIME(3)`,说明见[时间修复与部署](../timezone-fix.md);不修改历史数据。
- USDT 金额使用 `DECIMAL(30,6)`,业务计算使用精确十进制。
- 表间采用逻辑外键;归属、网络、状态机、金额非负及跨表一致性由应用落实。
- `ENERGY` 数量单位为 Energy,`BANDWIDTH` 为 bytes;本金单位为 SUN,1 TRX = 1,000,000 SUN。
@@ -221,7 +221,7 @@
| `verified_total_* / verified_resource_quantity` | 确认区块参数及本单资源额度 |
| `baseline_sun / after_sun` | 同地址对同资源类型的前后关系证据 |
| `block_height / evidence / confirmed_at` | 确认高度、证据和时间 |
| `block_time` | 独立查询交易所在区块的 UTC 时间,作为服务起点 |
| `block_time` | 独立查询交易所在区块的时间,转换为服务器本地DATETIME保存,作为服务起点 |
| `status / next_check_at` | REPORTED、CONFIRMED、FAILED、UNKNOWN 及核对计划 |
**功能流程:** Agent 上报原 txId → 云端查询交易、回执和委托关系 → 校验网络、地址、类型、金额及确认规则 → 委托额覆盖冗余目标才可认定交付成功 → 更新任务和订单。未知则继续查询原 txId。
@@ -520,7 +520,7 @@ flowchart TD
### 2.17 rent_user_package:系统用户套餐绑定
系统用户与具体套餐版本多对多绑定。user_id 对应 sys_user,package_id 对应 rent_package;network/resource_type 从套餐复制,status 控制新单授权,default_slot=1 为该网络该资源的当前项,其他为 NULL。唯一(user_id,package_id)防重复,唯一(user_id,network,resource_type,default_slot)保证分类唯一。created_by 记录管理员,version 和 UTC 时间用于更新与追溯。
系统用户与具体套餐版本多对多绑定。user_id 对应 sys_user,package_id 对应 rent_package;network/resource_type 从套餐复制,status 控制新单授权,default_slot=1 为该网络该资源的当前项,其他为 NULL。唯一(user_id,package_id)防重复,唯一(user_id,network,resource_type,default_slot)保证分类唯一。created_by 记录管理员,version 和服务器本地时间用于更新与追溯。
管理员选用户→绑定已上架套餐→替换同网络同资源的当前项;应用通过 rent_app.user_id 使用绑定。新单必须指定网络和资源类型,禁止提交套餐ID,服务端匹配此分类的当前有效绑定;订单快照保存绑定编号和用户编号。停用不影响历史订单。详见 [绑定与部署说明](user-package-bindings.md)。当前核心表总计17张,前述16张为原基线。
+6
View File
@@ -1,5 +1,11 @@
# 租赁三端实现验证记录
## 2026-11-02 时间口径修复
- JDK8、`-Duser.timezone=Asia/Shanghai` 全后端回归:system 215项、admin 29项,无失败/错误,4项既有测试跳过。
- 主从数据源绑定、时间点往返和URL归一化测试已通过。按用户要求,后续移除了迁移确认开关及对应测试;保留UTC、东八区、纽约时间点往返、响应ISO时间不变和连接配置归一化验证。
- 不处理历史数据,已移除时间迁移SQL及启动确认要求。部署说明见[时间修复与部署](../timezone-fix.md)。未连接生产数据库。
基础验证日期:2026-10-22;内置历史服务验证更新:2026-10-23。以当前工作区为准,不比较历史提交,不操作业务数据库,不执行真实链上广播。
## 已执行验证
+44
View File
@@ -0,0 +1,44 @@
# 数据库时间与服务器相差8小时的修复
## 根因与统一规则
旧租赁实现将DATETIME(3)按UTC写入,而支付Date、日志和Jackson使用JVM本地时区,因此东八区服务器查看租赁原始记录会相差8小时。
修复后,租赁DATETIME使用服务器/JVM本地时间;SQL CURRENT_TIMESTAMP和MySQL连接会话采用相同时区。协议签名、链上毫秒时间戳及HTTP带Z的ISO时间仍表示真实时间点。
按用户要求,本次只修复代码,不修改历史记录;已移除历史数据迁移脚本、迁移标记逻辑及启动确认开关,启动无需配置RENT_LOCAL_TIME_STORAGE_READY。旧记录保持原值,不会自动加8小时。
## 修复范围
- RentalValues统一本地时间写入及Timestamp/LocalDateTime读取。
- 快照、节点心跳、订单调度、回收、任务期限、链上证明及历史保留截止时间使用统一转换。
- 充值失效时间、提现交易时间与审核时间使用同一口径。
- 历史采集/清理租约和worker到期判断使用CURRENT_TIMESTAMP。
- 看板按本地自然日统计,timezone返回服务器时区;接口ISO时间保持真实时间点。
- MySQL主从连接统一connectionTimeZone=LOCAL及forceConnectionTimeZoneToSession=true,消除驱动固定GMT+8与JVM时区不一致的问题。Connector/J使用8.0.30。
- 七牛配置对象移除独立硬编码GMT+8的序列化设置,遵循JVM/Jackson时区。
- 初始化DDL、实体字段说明、套餐种子及绑定维护SQL同步更新。
UTC 02:00核账和UTC 03:15历史清理是明确安排的定时执行时间,保持不变。JWT、HMAC时间戳、链上epoch毫秒和签名载荷不变。
## 部署与核对
部署更新后的服务及依赖lib(包括Connector/J 8.0.30),保持JVM时区与服务器业务时区一致。东八区示例:
```bash
java -Duser.timezone=GMT+08:00 -jar ruoyi-admin.jar
```
使用Asia/Shanghai等命名时区时,MySQL需要加载对应时区表,驱动会设置同一会话时区。运行期间不要改变JVM时区。
检查启动日志“数据库时间配置”,再核对新订单、快照更新时间与服务器当前时间。数据库会话可查询:
```sql
SELECT NOW(3), UTC_TIMESTAMP(3), @@session.time_zone, @@global.time_zone, @@system_time_zone;
```
接口ISO字符串仍可带Z,表示UTC格式的同一真实时间点,不表示数据库仍有8小时偏移。
## 验证范围
已在东八区执行后端回归,以及UTC、东八区、纽约时区的时间点往返、响应序列化、JDBC URL归一化和主从配置绑定测试。未操作生产数据库或执行真实链上广播。