Liferay 7.4中Gradle buildService异常，API服务部署失败

问题背景 #

在Liferay框架中使用Gradle部署API服务，执行buildService后部署时出现错误：error : Exporting an empty package 'com.test.exception'。当前构建目录结构不符合预期，期望的正确目录结构应为：

|-apiService
  |-main
    |-java
      |-com.testService.exception
      |-com.testservice.model
      |-com.testService.service

解决步骤 #

• 检查bnd配置文件（通常为bnd.bnd）：查看Export-Package配置项，若其中包含com.test.exception且该包为空，直接移除该包的导出声明；若需要保留该包导出，确保包内存在对应的异常类文件。
• 核对service.xml的包名配置：buildService基于service.xml生成代码，检查文件中实体、异常相关的包名是否与期望的com.testService.*一致，避免因包名拼写（如com.test和com.testService）错误导致生成空包。
• 清理并重新生成服务代码：执行gradle clean清理旧构建文件，再执行gradle buildService重新生成代码，确保目录结构正确生成。
• 统一包名大小写：Liferay对包名大小写敏感，确认生成的包目录与期望的com.testService.exception大小写一致，避免因大小写差异导致识别为空包。

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