Android Studio Arctic Fox搭配Gradle6.7出现port out of range:-1报错咨询

问题1：Android Studio Arctic Fox 2020.3.1 Patch 2与Gradle 6系列是否存在兼容性问题 #

不存在兼容性问题。根据Android Studio官方的版本匹配规则，Arctic Fox (2020.3.1) 版本支持的Gradle版本范围为 6.7 - 7.0.2，你使用的Gradle 6.7属于官方兼容的版本区间，无需担心版本适配问题。

问题2：报错的可能触发原因 #

你遇到的 port out of range:-1 报错核心原因是Gradle在触发构建完成回调时，尝试访问的网络端口数值无效，常见触发场景如下：

• 代理配置错误：全局或项目层级的gradle.properties文件中，HTTP/HTTPS代理的proxyPort参数被误设为-1、参数缺失或格式错误，导致Gradle读取到无效的端口值。
• Gradle守护进程异常：本地残留的Gradle守护进程状态异常，缓存了错误的端口配置，无法和Android Studio的构建监听服务正常通信。
• 自定义构建逻辑异常：项目引入的第三方Gradle插件、自定义构建监听器中，存在网络请求相关的逻辑，端口号被硬编码为-1、读取配置失败时返回了无效值，在buildFinished回调执行时触发报错。
• 本地网络配置异常：系统hosts文件中127.0.0.1对应localhost的配置被篡改，导致Gradle和Android Studio之间的本地进程通信的端口解析失败。

对应修复方案 #

• 检查所有gradle.properties文件（包括系统用户目录下的全局配置文件、项目根目录下的项目配置文件），确认代理相关配置的proxyPort参数为1-65535之间的合法数值，不需要使用代理的情况下直接删除所有代理相关配置即可。
• 执行命令./gradlew --stop终止所有本地运行的Gradle守护进程，重启Android Studio后重新尝试构建。
• 临时注释掉项目中新增的第三方Gradle插件、自定义构建监听逻辑，逐一排查定位触发报错的代码段。
• 检查系统hosts文件，确保存在127.0.0.1 localhost的默认配置。

内容的提问来源于stack exchange，提问作者jitendra kumar