AEM项目添加Jsoup依赖后报cannot be resolved to a type错误如何解决

1 先区分报错场景 #

• 编译期报错：IDE开发阶段就提示类找不到
• 运行期报错：部署到AEM后请求页面/接口时，日志抛出该异常

2 编译期报错排查步骤 #

• 执行mvn clean compile检查MySlingModel所在core模块是否存在编译错误，确认Jsoup依赖已正确添加到core模块的pom.xml中

AEM 6.5+版本已内置Jsoup，推荐直接用内置版本，依赖配置参考：

<dependency>
    <groupId>org.jsoup</groupId>
    <artifactId>jsoup</artifactId>
    <scope>provided</scope>
</dependency>

• 若OSGi服务和MySlingModel分属不同模块，确认服务所在模块已引入core模块依赖，scope设为provided

3 运行期报错排查步骤 #

• 第一步检查项目core bundle状态：进入AEM控制台/system/console/bundles，搜索项目core bundle，确认状态为Active
  • 若状态为Installed，点击bundle名称查看缺失依赖包，确认是否为Jsoup相关包未导入
• 检查SlingModel扫描配置：打开core模块的maven-bundle-plugin配置，确认已添加SlingModel包扫描规则，示例配置如下：

<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <extensions>true</extensions>
    <configuration>
        <instructions>
            <!-- 配置SlingModel扫描包路径 -->
            <Sling-Model-Packages>com.project.core.models</Sling-Model-Packages>
            <!-- 跨模块使用MySlingModel需导出对应包 -->
            <Export-Package>com.project.core.models.*;version="${project.version}"</Export-Package>
            <!-- 若使用自定义版本Jsoup，需添加嵌入配置，此时Jsoup依赖scope设为compile -->
            <Embed-Dependency>jsoup;scope=compile</Embed-Dependency>
        </instructions>
    </configuration>
</plugin>

• 检查注入注解配置：确认MySlingModel中注入OSGi服务使用标准OSGi R6+注解@Reference，避免使用过时注解导致类加载异常

4 验证操作 #

完成配置修正后，执行全量构建部署命令mvn clean install -PautoInstallPackage，部署完成后重启项目core bundle，验证功能是否正常。

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