Halo2.x 开源博客主题Theme-Hao

本资源为Halo2.x博客系统的Theme-Hao主题源码包，需严格遵循版本兼容性要求部署。主题采用Java+Freemarker技术架构开发，适配Halo 2.17.0及以上版本运行环境，自定义登录页功能需Halo 2.20.0+版本支持。

版本适配说明

1. ​核心版本对照表主题版本Halo最低版本主要特性支持1.5.52.17.0基础模板渲染1.6.02.20.0自定义登录页
2. ​环境检测机制
   • 启动时自动校验Halo版本：javaif (haloVersion.compareTo(Version.parse("2.17.0")) < 0) { throw new ThemeException("Halo版本过低"); }

常见问题解决方案

1. ​500错误处理流程
   • 强制刷新主题配置：
     1. 访问 /admin/themes/current/settings
     2. 逐个保存所有配置项（包含空值选项）
     3. 重启Halo服务
   • 配置缓存清理路径：bashrm -rf ~/.halo2/caches/themes/theme-hao
2. ​兼容性故障排查
   • 版本信息查看命令：bashjava -jar halo.jar --version
   • 日志分析位置：text/logs/halo.log /logs/theme-hao-error.log

技术支持路径

服务器资源监控数据（CPU/内存占用率）

​自助排查顺序

第一优先级：查阅主题文档的「更新说明」章节

第二优先级：比对GitHub的Release Notes变更记录

第三优先级：社群技术讨论组（QQ群号见文档）

​问题提交规范

ISSUE模板必须包含：

Halo详细版本号

主题安装包MD5校验值

错误日志关键片段（脱敏处理）

问题复现步骤需提供：

浏览器控制台Network截图

如果安装主题后报错，请仔细查阅主题说明 与更新说明！！！

如果还未解决，可以加群求助！！！

如果群友也解决不了，再考虑提ISSUE！！！

1.5.5及以上版本需要Halo版本>=2.17.0

1.6.0及以上版本需要Halo版本>=2.20.0（自定义登录页兼容）

若安装主题后出现500错误，请到主题设置页面，将每个设置项都保存一下！！！