zhini_im/检查高德Key配置.md

高德Key配置检查指南

错误代码 1008 说明

错误代码 1008 表示"Key鉴权未通过"，通常由以下原因导致：

可能的原因：

1. Key与包名不匹配

   • 当前应用包名：com.xunpaisoft.social
   • 需要在控制台确认Key绑定的包名是否一致

2. Key与SHA1不匹配

   • Debug版本和Release版本可能使用不同的签名
   • 需要同时配置Debug和Release的SHA1

3. 搜索服务权限未开启

   • 逆地理编码需要使用搜索服务
   • 需要在控制台为Key开启"搜索服务"权限

4. Key类型不匹配

   • 必须使用Android平台的Key
   • 不能使用Web服务的Key

检查步骤

1. 获取应用的SHA1签名

方法一：使用keytool命令（推荐）

Debug版本签名：

# 查看debug keystore的SHA1（通常在用户目录下）
keytool -list -v -keystore %USERPROFILE%\.android\debug.keystore -storepass android -alias androiddebugkey | findstr /i "SHA1"

Release版本签名：

# 查看项目keystore的SHA1
keytool -list -v -keystore keystore2 -storepass yuchen.com -alias yuchen | findstr /i "SHA1"

方法二：通过Android Studio获取

1. 打开Android Studio
2. 点击右侧 Gradle 面板
3. 展开：app → Tasks → android
4. 双击 signingReport
5. 在Build窗口查看SHA1值

2. 登录高德开放平台检查Key配置

访问：https://lbs.amap.com/

1. 登录控制台

2. 进入"应用管理" → 找到对应的应用

3. 检查Key配置：

   • ✅ 包名：com.xunpaisoft.social
   • ✅ SHA1：必须与应用的SHA1签名一致
   • ✅ 平台：必须是"Android平台"

4. 检查服务权限：

   • ✅ 定位服务：必须开启
   • ✅ 搜索服务：必须开启（用于逆地理编码）

3. 当前配置信息

包名：com.xunpaisoft.social
Key：2c5aa17a9ae467543613267692b4a206

4. 常见问题解决

问题1：Key与SHA1不匹配

解决方案：

1. 获取正确的SHA1签名（见步骤1）
2. 在高德控制台添加该SHA1到Key配置中
3. 重新编译运行

问题2：搜索服务权限未开启

解决方案：

1. 登录高德控制台
2. 进入Key管理页面
3. 找到对应的Key
4. 在"服务"选项中勾选"搜索服务"
5. 保存配置

问题3：使用了错误的Key类型

解决方案：

1. 确认Key是"Android平台"类型
2. 如果是"Web服务"类型，需要重新创建"Android平台"的Key

5. 验证配置

配置完成后，重新编译运行应用，查看日志：

成功日志：

AMapLocationHelper: 高德搜索服务API Key设置成功: 2c5aa17***
AMapLocationHelper: 逆地理编码成功 - 地址: xxx

失败日志（1008错误）：

AMapLocationHelper: 逆地理编码失败 - 错误代码: 1008

如果仍有1008错误，请检查：

1. SHA1是否正确配置
2. 搜索服务权限是否已开启
3. 包名是否匹配

快速检查命令

# 检查Debug SHA1
keytool -list -v -keystore %USERPROFILE%\.android\debug.keystore -storepass android -alias androiddebugkey | findstr /i "SHA1"

# 检查Release SHA1
keytool -list -v -keystore keystore2 -storepass yuchen.com -alias yuchen | findstr /i "SHA1"