OneAPI 迁移至 OneHub 时保持用户令牌不变的解决方案

背景介绍

在将 OneAPI 系统迁移到 OneHub 平台的过程中，许多开发者会遇到用户令牌(token)兼容性问题。由于两个系统采用了不同的令牌生成和验证机制，直接迁移会导致原有令牌失效，影响用户体验和系统集成。

问题本质

OneAPI 和 OneHub 虽然功能相似，但在令牌管理上存在差异：

1. 令牌生成算法不同
2. 令牌ID分配机制不同
3. 验证逻辑有所调整

这种差异导致直接从 OneAPI 数据库迁移过来的令牌无法在 OneHub 系统中正常使用。

解决方案详解

要解决令牌迁移问题，需要修改 OneHub 数据库中的关键配置项：

1. 定位关键配置表：在 OneHub 数据库中，找到 options 表
2. 修改关键参数：将 OldTokenMaxId 的值设置为迁移令牌中的最大ID值
3. 重启服务：修改完成后需要重启 OneHub 服务使配置生效

操作示例

假设从 OneAPI 迁移过来的令牌ID最大值为100，则应执行以下SQL：

UPDATE options SET option_value = '100' WHERE option_name = 'OldTokenMaxId';

注意事项

1. ID值确定：必须准确获取迁移令牌中的最大ID值，设置过小会导致部分令牌失效
2. 服务重启：修改后必须重启服务，否则更改不会生效
3. 测试验证：修改完成后应测试各类令牌的可用性
4. 备份数据：操作前务必备份数据库，防止意外情况发生

技术原理

OneHub 通过 OldTokenMaxId 参数来区分新旧令牌的验证方式：

• ID小于等于此值的令牌采用旧验证逻辑
• ID大于此值的令牌采用新验证逻辑

这种设计实现了向后兼容，确保迁移过程平滑进行。

最佳实践建议

1. 在迁移前记录原有系统的最大令牌ID
2. 考虑在低峰期执行迁移操作
3. 准备回滚方案，以防出现意外情况
4. 迁移完成后监控系统日志，确保令牌验证正常

通过以上方法，开发者可以顺利完成从 OneAPI 到 OneHub 的令牌迁移，保持系统稳定性和用户体验的一致性。