高德/百度地圖 Android Key 報 INVALID_USER_SCODE 解決：包名與 SHA1 配置細節

Android 應用集成高德或百度地圖 SDK 時，真機調試出現 INVALID_USER_SCODE、僅顯示白色網格，多數是簽名證書與控制台配置不一致導致。

根因分析

• Debug 與 Release 簽名證書不同，SHA1 指紋自然不同。
• 開發者在控制台填寫的包名可能為 applicationId（Gradle 可動態修改），而非 AndroidManifest.xml 真實 package 屬性值。
• 高德控制台要求「輸入包名」處填寫 Manifest 真實 package 名，而非 applicationId。

排查清單

1. 確認當前簽名模式（Debug/Release），取得對應 keystore 的 SHA1：

   keytool -list -v -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android

2. 在高德/百度開放平台控制台：
   應用包名 = AndroidManifest.xml package="com.example.app"
   SHA1 = 當前簽名證書指紋
3. 清理專案、卸載舊版 App、重新安裝測試。

一句話總結

Manifest 的 package 名 + 當前簽名 SHA1 = 控制台配置，兩邊嚴格一致，問題即解。