AEM项目嵌入google-maps-services依赖失败问题求助

问题根源说明 #

你遇到的两个问题本质都是OSGi环境下的依赖管理问题：

1. 直接添加Maven依赖后类无法解析：因为AEM基于OSGi，普通JAR依赖不会自动被OSGi容器识别，必须将依赖嵌入到你的OSGi bundle中。
2. 嵌入后Felix控制台找不到google-maps bundle：因为嵌入依赖是将第三方类打包到你自己的bundle中，不会生成单独的google-maps bundle，你应该检查自己的bundle状态而非寻找独立的google-maps bundle。

步骤1：配置Maven依赖 #

在项目pom.xml中添加google-maps-services及其依赖，范围设为compile（确保编译时可用，后续嵌入到bundle）：

<dependencies>
    <!-- Google Maps Geocoding API依赖 -->
    <dependency>
        <groupId>com.google.maps</groupId>
        <artifactId>google-maps-services</artifactId>
        <version>0.18.0</version> <!-- 使用最新稳定版 -->
        <scope>compile</scope>
    </dependency>
    <!-- 依赖的第三方库 -->
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>4.9.3</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.squareup.okio</groupId>
        <artifactId>okio</artifactId>
        <version>2.10.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>io.opencensus</groupId>
        <artifactId>opencensus-api</artifactId>
        <version>0.31.0</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.8.9</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

步骤2：修复OSGi Bundle嵌入配置 #

你的bnd配置存在格式错误和冗余设置，推荐使用AEM项目标准的maven-bundle-plugin来配置：

<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>5.1.9</version>
    <extensions>true</extensions>
    <configuration>
        <instructions>
            <!-- 替换为你的bundle标识 -->
            <Bundle-SymbolicName>com.yourcompany.yourproject.maps</Bundle-SymbolicName>
            <Bundle-Name>Your Project Maps Service</Bundle-Name>
            <Bundle-Version>1.0.0</Bundle-Version>
            
            <!-- 导入必要的OSGi包，*表示自动导入其他依赖 -->
            <Import-Package>
                javax.annotation;version=0.0.0,
                javax.net.*;version=0.0.0,
                com.day.cq.search;version="[1.3.0,2)",
                com.day.cq.wcm.api;version="[1.27.0,2)",
                org.apache.commons.lang3;version="[3.9.0,4)",
                org.apache.sling.api.resource;version="[2.11.1,3)",
                *
            </Import-Package>
            
            <!-- 嵌入google-maps-services及其依赖 -->
            <Embed-Dependency>
                google-maps-services,okhttp,okio,opencensus-api,gson
            </Embed-Dependency>
            <Embed-Transitive>true</Embed-Transitive> <!-- 自动嵌入传递依赖 -->
            
            <!-- 只导出你自己的业务包，不要导出第三方包 -->
            <Export-Package>
                com.yourcompany.yourproject.maps.*;version=1.0.0
            </Export-Package>
        </instructions>
    </configuration>
</plugin>

关键配置说明： #

• Embed-Dependency：指定要嵌入的依赖包，用逗号分隔，不要换行（避免bnd解析错误）。
• Embed-Transitive：自动嵌入依赖包的传递依赖，省去手动添加所有子依赖的麻烦。
• Export-Package：仅导出你自己的代码包，不要导出第三方包（防止类冲突）。

步骤3：验证部署状态 #

1. 执行mvn clean install构建项目，部署到AEM实例。
2. 打开Felix控制台（/system/console/bundles），搜索你的bundle符号名称（如com.yourcompany.yourproject.maps）。
3. 确认bundle状态为Active：
   • 若状态为Resolved，查看/system/console/slinglog的错误日志，补充缺失的导入包到Import-Package中。
   • 不要寻找单独的google-maps bundle，因为它已经嵌入到你的bundle里了。

步骤4：代码中使用Geocoding API #

在OSGi组件中初始化客户端并调用API，注意在组件销毁时关闭客户端：

import com.google.maps.GeoApiContext;
import com.google.maps.GeocodingApi;
import com.google.maps.model.GeocodingResult;
import com.google.maps.model.LatLng;
import org.osgi.service.component.annotations.Activate;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Deactivate;

@Component(service = GeocodingService.class, immediate = true)
public class GeocodingService {

    private GeoApiContext geoApiContext;

    @Activate
    protected void activate() {
        // 替换为你的Google Maps API密钥
        geoApiContext = new GeoApiContext.Builder()
                .apiKey("YOUR_GOOGLE_MAPS_API_KEY")
                .build();
    }

    @Deactivate
    protected void deactivate() {
        if (geoApiContext != null) {
            geoApiContext.shutdown();
        }
    }

    /**
     * 根据经纬度获取地址
     */
    public String getAddressFromLatLng(double latitude, double longitude) throws Exception {
        GeocodingResult[] results = GeocodingApi.reverseGeocode(
                geoApiContext,
                new LatLng(latitude, longitude)
        ).await();
        
        return results != null && results.length > 0 ? results[0].formattedAddress : null;
    }
}

常见问题排查 #

• 类找不到错误：确保Embed-Transitive设为true，所有传递依赖都被嵌入。
• Bundle无法激活：检查日志中的缺失导入包，添加到Import-Package。
• API调用失败：确认API密钥启用了Geocoding API权限，且AEM实例能访问https://maps.googleapis.com。

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