IDEA中Android SDK配置失败

Question

在IntelliJ IDEA中配置Android SDK时，常出现“Android SDK not found”错误，即使已正确安装SDK并设置了环境路径。问题多源于IDE未识别自定义SDK路径或SDK目录权限受限。此外，SDK路径包含中文或空格字符也会导致解析失败。部分情况下，project structure中的模块SDK引用为空或指向无效目标，亦会引发配置异常。需检查全局与模块级SDK设置是否一致，并确保SDK平台工具完整下载。

Answer 1

1. 常见现象与初步排查

在IntelliJ IDEA中配置Android SDK时，用户常遇到“Android SDK not found”错误提示。尽管已在系统中安装了Android SDK并设置了环境变量（如ANDROID_HOME），IDE仍无法识别SDK路径。该问题通常表现为项目构建失败、Gradle同步异常或模块编译报错。

• 检查是否已正确设置ANDROID_HOME环境变量，并指向有效的SDK根目录。
• 确认IntelliJ IDEA是否重启以加载最新的环境变量配置。
• 查看IDE的日志输出（Help → Show Log in Explorer）中是否有路径解析相关的警告信息。

部分开发者误以为只要环境变量存在即可自动生效，但实际上IntelliJ IDEA使用自身维护的SDK配置体系，不完全依赖操作系统级变量。

2. 路径规范性与字符限制分析

SDK路径若包含中文字符、空格或特殊符号（如C:\Program Files\Android SDK），可能导致IDE内部路径解析器解析失败。Java NIO和某些JNI调用对非ASCII路径支持不佳，尤其在跨平台场景下更为明显。

路径类型	是否推荐	说明
C:\Android\Sdk	✅ 推荐	纯英文、无空格、短路径
C:\Users\张伟\AppData\Local\Android\Sdk	❌ 不推荐	含中文用户名
C:\Program Files\Android SDK	⚠️ 风险较高	含空格，需转义处理

建议将SDK迁移至不含空格和非ASCII字符的路径，例如D:\Android\Sdk，并在IDE中重新指定该路径。

3. 权限与文件访问控制机制

即使路径正确，若SDK目录被操作系统权限限制（如Windows上的UAC保护或Linux中的chmod权限不足），IntelliJ IDEA可能无法读取关键组件（如platforms/、tools/）。此问题多出现在多用户系统或企业IT策略严格管控环境中。

# Linux/macOS 下检查权限
ls -la ~/Android/Sdk/
# 若显示权限为 755 或更低，可尝试：
chmod -R 755 ~/Android/Sdk/
chown -R $USER ~/Android/Sdk/

Windows用户应确保当前账户对SDK目录具有完全控制权限，可通过右键属性→安全选项卡进行验证。

4. 全局与模块级SDK配置一致性校验

IntelliJ IDEA采用两级SDK管理模型：全局Project SDK与模块级Module SDK。若两者不一致或模块未绑定有效SDK，会触发“SDK not found”错误。

1. 进入 File → Project Structure → Platform Settings → SDKs
2. 确认是否存在Android SDK条目，且路径指向有效目录
3. 切换至 Modules 页面，检查每个模块的 Dependencies 选项卡中 SDK 引用是否为空或失效
4. 手动选择正确的Android SDK作为模块依赖

常见误区是仅配置了全局SDK却忽略了模块级别的具体引用设置。

5. SDK组件完整性验证与补全下载

即便路径识别成功，缺少必要平台工具也会导致功能异常。例如缺失platform-tools、build-tools或特定API级别的android.jar。

graph TD
    A[启动SDK Manager] --> B{检查以下组件}
    B --> C[Android SDK Tools]
    B --> D[Android SDK Platform-tools]
    B --> E[Android SDK Build-tools]
    B --> F[至少一个Android API Platform]
    C --> G[是否已安装?]
    D --> G
    E --> G
    F --> G
    G -->|否| H[执行安装]
    G -->|是| I[继续下一步]

通过SDK Manager确保所有必需组件均已下载并处于最新状态。

6. IDE缓存与配置重置策略

长期使用IntelliJ IDEA可能导致配置缓存污染，特别是从旧版本升级后。此时即使路径正确，IDE也可能沿用旧的无效引用。

// 清理IDE缓存步骤：
// 1. 关闭项目
// 2. File → Invalidate Caches / Restart...
// 3. 选择 "Invalidate and Restart"
// 4. 重启后重新导入项目并配置SDK

此外，可手动删除.idea目录下的misc.xml和modules.xml以强制重建项目结构配置。