BiliBiliToolPro项目青龙面板授权文件缺失问题分析与解决方案

问题背景

BiliBiliToolPro是一个基于.NET开发的B站自动化工具项目，常与青龙面板配合使用实现定时任务管理。近期用户反馈在青龙面板2.18.0版本中，BiliBiliToolPro项目出现授权文件缺失问题，导致无法正常添加定时任务和持久化Cookie。

问题现象

用户在使用过程中发现以下异常情况：

1. 通过青龙订阅安装代码拉取成功后，所有自动添加定时任务的操作均失败
2. 手动执行bili扫码登录定时任务时，虽然能获取二维码但提示auth.json文件不存在
3. 系统无法持久化Cookie信息
4. 容器内检查确实缺少/ql/data/config/auth.json配置文件

技术分析

授权机制变更

青龙面板在2.18.0版本中对授权机制进行了调整，移除了传统的auth.json文件授权方式。而BiliBiliToolPro项目当前版本仍依赖该文件进行青龙API的授权认证。

文件路径变更

新版本青龙面板对文件存储结构进行了优化，将配置文件和运行时数据分离存储。BiliBiliToolPro项目需要适配新的路径结构。

环境变量机制

青龙面板提供了环境变量管理功能，可以作为临时存储Cookie的替代方案，但需要手动配置。

解决方案

临时解决方案

1. 手动添加环境变量：

   • 登录青龙面板
   • 进入"环境变量"管理页面
   • 添加名为"Ray_BiliBiliCookies__1"的环境变量
   • 值为扫码登录后获取的Cookie信息

2. 降级青龙版本：

   • 回退到支持auth.json授权方式的青龙面板版本
   • 推荐使用2.17.x系列版本

长期解决方案

项目维护者已确认将在后续版本中适配新的青龙面板授权机制，用户可关注项目更新。

最佳实践建议

1. 对于生产环境，建议暂时使用青龙面板2.17.x稳定版本
2. 开发环境可以尝试手动配置环境变量的方式
3. 定期备份重要配置和数据
4. 关注项目官方更新公告，及时升级适配版本

总结

BiliBiliToolPro项目与青龙面板的集成问题主要源于授权机制的变更。通过理解问题本质，用户可以选择合适的临时解决方案，同时期待官方的新版本适配。这类问题在开源项目协作中较为常见，体现了不同项目间API兼容性的重要性。