编译android-tv-homekit遇compileDebugJavaWithJavac找不到符号类

错误根因 #

cannot find symbol class io.github.hapjava.HomekitCharacteristicChangeCallback属于类匹配失败错误，触发原因共两类：要么代码中写的类导入路径和实际依赖的hapjava库路径不一致，要么Gradle没有正确拉取到包含对应类的hapjava依赖包。

分步修复 #

• 修正导入路径
  你当前使用的导入语句是旧版本hapjava的路径，2.0及以上版本的hapjava已经把HomekitCharacteristicChangeCallback类移动到io.github.hapjava.characteristics包下，全局搜索项目里所有出现

  import io.github.hapjava.HomekitCharacteristicChangeCallback;
  

  的位置，统一替换为：

  import io.github.hapjava.characteristics.HomekitCharacteristicChangeCallback;
  

• 校验依赖仓库配置
  hapjava的公开仓库托管在JitPack，检查项目级配置文件（老版本Android Studio查看根目录build.gradle，新版本查看根目录settings.gradle）的repositories块，必须包含JitPack仓库配置，且该配置要在dependencyResolutionManagement下，不能仅放在buildscript块内：

  maven { url 'https://jitpack.io' }
  

• 清除缓存重新拉取依赖
  配置改完后先执行清理命令：
  类Unix系统（Mac/Linux）在项目根目录终端执行：

  ./gradlew clean
  

  Windows系统在项目根目录cmd/PowerShell执行：

  gradlew.bat clean
  

  清理完成后删除项目根目录下的.gradle隐藏文件夹，再打开Android Studio依次点击File > Invalidate Caches...，勾选「Clear file system cache and Local History」后点击Invalidate and Restart，等IDE重启完成后重新触发构建即可。
• 版本回退兜底
  如果上述操作后还是报错，说明你手动升级过hapjava依赖版本，直接把app/build.gradle里的hapjava依赖版本回退到android-tv-homekit项目初始提交时指定的版本，不要随意升级依赖版本，避免其他类路径、接口变动触发更多编译错误。

验证方式 #

修复完成后单独执行Java编译任务验证：

./gradlew :app:compileDebugJavaWithJavac

任务执行成功不报错即代表该问题修复完成。

内容的提问来源于stack exchange，提问作者Zarkhas