这个问题我之前帮不少开发者排查过，升级到Android Studio 3.1后出现的"AIDL is missing"错误，本质是指定版本的Build Tools里的aidl可执行文件缺失，或者IDE没能正确读取到这个文件。结合你给出的报错路径/Users/user_name/Documents/sdk/build-tools/27.0.3/aidl，给你几个逐步排查的解决方案：

• 检查Build Tools 27.0.3是否完整安装
  打开Android Studio的SDK Manager（可以通过Tools -> SDK Manager打开），切换到SDK Tools标签，找到Android SDK Build-Tools 27.0.3：

  • 如果没勾选，直接勾选后点击"Apply"安装；
  • 如果已经安装，先取消勾选卸载，然后重新勾选安装（有时候安装过程中会出现文件损坏或遗漏）。

• 确认gradle配置中的Build Tools版本
  打开app模块下的build.gradle文件，检查android块中的buildToolsVersion配置是否正确：

  android {
      buildToolsVersion "27.0.3"
      // 其他配置...
  }
  

  如果确认该版本有问题，可以尝试升级到兼容的更高版本（比如28.0.3，前提是项目的compileSdkVersion支持），修改后同步gradle。

• 清理并重建项目
  有时候IDE缓存会导致文件识别异常，依次执行：

  1. Build -> Clean Project
  2. Build -> Rebuild Project
     完成后重新编译项目，看报错是否消失。

• 验证SDK路径配置
  检查Android Studio的SDK路径是否指向正确的目录：
  通过File -> Project Structure -> SDK Location查看，确保路径是/Users/user_name/Documents/sdk，并且该路径下的build-tools/27.0.3目录中确实存在aidl文件（如果没有，说明Build Tools安装不完整）。

• 临时修复：手动复制aidl文件（不推荐长期使用）
  如果上面的方法都无效，可以从其他正常安装的Build Tools版本（比如28.0.3）的目录中复制aidl文件，粘贴到/Users/user_name/Documents/sdk/build-tools/27.0.3/目录下，但这只是临时方案，建议还是通过重新安装Build Tools来彻底解决。

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