Readest自托管部署中的数据库同步问题与解决方案

问题背景

在Readest项目的自托管部署过程中，用户尝试通过Vercel平台同步个人书籍数据时遇到了两个关键问题。这些问题主要涉及数据库表结构不匹配和订阅计划默认配置问题。

数据库表结构同步问题

错误现象

在同步API调用过程中，系统报错提示无法在schema缓存中找到books表的group_id列。错误信息明确指出：

Error: Could not find the 'group_id' column of 'books' in the schema cache

问题分析

1. 表结构不一致：项目Wiki文档中记录的books表结构仅包含"group"字段，而实际代码中却依赖"group_id"字段
2. 版本差异：文档未及时更新到最新版本，导致自托管用户无法正确配置数据库

解决方案

项目维护者已更新Wiki文档，包含了最新的数据库表结构。用户需要：

1. 参照最新文档重新配置Supabase数据库表结构
2. 确保所有必需字段(包括group_id)都已正确创建
3. 验证表结构与代码要求的完全匹配

订阅计划默认配置问题

现象描述

自托管环境下，用户配置始终显示为"free"版本，仅提供500MB同步空间，且无法直接修改。

技术分析

1. 配额类型：系统内置三种配额类型

   • free：基础版，500MB空间
   • plus：增强版
   • pro：专业版

2. 默认机制：当JWT令牌中不包含"plan"字段时，系统默认返回"free"计划

优化方案

针对自托管环境，可以考虑以下两种优化方式：

1. JWT令牌修改方案

   • 在Supabase中创建Auth Hook
   • 编辑返回的JWT令牌，添加plan字段
   • 需要一定的JWT和RBAC知识基础

2. 代码默认值修改方案

   • 直接修改源代码中的默认返回值
   • 将默认计划调整为"pro"或其他所需版本
   • 需要重新部署应用

推荐方案

对于大多数自托管用户，建议采用第二种方案，即修改代码默认值。这种方法：

• 实施简单，无需深入理解JWT机制
• 一次修改，长期有效
• 不影响其他安全机制

实施建议

1. 在进行任何修改前，务必备份当前数据库和代码
2. 严格按照最新文档配置数据库结构
3. 对于订阅计划修改，评估实际存储需求后再决定采用哪种方案
4. 部署后进行全面测试，确保所有功能正常

总结

Readest项目的自托管部署需要特别注意数据库结构的准确配置和订阅计划的合理设置。通过遵循最新文档和选择合适的配置方案，用户可以充分发挥自托管环境的优势，获得更好的使用体验。项目维护团队也会持续更新文档，确保用户能够获得准确的技术参考。