Android Studio运行应用报错：Task :app:validateSigningDebug失败无法创建~\.android\.android目录

解决方案 #

该错误核心是Android Studio解析用户配置目录时出现路径重复，导致尝试创建非法的嵌套.android目录，可按以下步骤依次排查：

1. 修复ANDROID_USER_HOME环境变量
   • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
   • 在当前用户的变量列表中新建条目，变量名填ANDROID_USER_HOME，变量值填绝对路径C:\Users\你的实际用户名\.android，替换占位符为你的Windows系统用户名，不要使用~相对路径标识
   • 保存所有配置后重启Android Studio，重新执行构建操作
2. 检查项目配置文件
   • 打开项目根目录下的local.properties文件，删除其中手动配置的错误.android相关路径，确保没有写死重复的目录配置
   • 打开app模块下的build.gradle文件，检查debug签名配置的storeFile参数，确认没有填写~/.android/.android/debug.keystore这类错误路径，正确配置参考：

     signingConfigs {
         debug {
             storeFile file("${System.getenv("ANDROID_USER_HOME")}/debug.keystore")
             storePassword "android"
             keyAlias "androiddebugkey"
             keyPassword "android"
         }
     }
     

3. 清理无效嵌套目录
   打开Windows用户根目录C:\Users\你的实际用户名，进入.android文件夹，如果内部存在另一个同名.android子文件夹，直接删除该子文件夹后重试构建。

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