macOS Catalina下NDK编译因-j16参数触发权限拒绝问题排查

一、-j16参数的作用 #

-j是make工具（ndk-build底层依赖的编译工具）的并行编译参数，后面的数字代表同时启动的编译任务线程数。-j16就是告诉ndk-build同时用16个线程执行编译任务，核心目的是充分利用多核CPU的性能，大幅缩短项目构建时间。旧电脑升级Catalina后能正常使用该参数，说明新电脑的环境和旧电脑存在细微的权限或系统配置差异。

二、查找并移除-j16参数的来源 #

这个参数的添加渠道主要集中在Android项目的Gradle配置或Android Studio的全局设置里，你可以按以下顺序排查：

1. 模块级build.gradle配置
   打开Android项目对应模块的build.gradle文件，找到externalNativeBuild下的ndkBuild块，查看是否有手动添加的arguments "-j16"：

   android {
       externalNativeBuild {
           ndkBuild {
               // 检查这里是否有类似配置
               arguments "-j16"
               path "Android.mk"
           }
       }
   }
   

   如果存在，直接删除这一行即可。

2. 项目级配置与全局Gradle文件

   • 检查项目根目录的gradle.properties文件，是否有和并行编译相关的全局配置（比如org.gradle.parallel=true，这是Gradle自身的并行机制，虽不是直接传给ndk-build的-j参数，但也可暂时关闭测试）；
   • 查看项目根目录的build.gradle，是否有针对所有模块的ndkBuild参数统一设置；
   • 检查用户目录下的~/.gradle/gradle.properties，是否存在影响并行编译的全局配置。

3. Android Studio全局编译器设置
   打开Android Studio的Preferences（Mac顶部菜单栏Android Studio→Preferences），依次进入Build, Execution, Deployment→Compiler：

   • 检查Command-line options输入框里是否添加了-j16之类的参数；
   • 暂时关闭Parallel project execution选项，测试是否还会出现权限错误。

三、8核处理器用大于2的-j值报错的解决思路 #

新电脑预装Catalina、旧电脑升级后无问题，大概率是系统权限或资源限制导致的，试试以下方案：

1. 递归设置NDK文件夹权限
   之前你用chmod 755可能没递归处理子文件，打开终端执行：

   chmod -R 755 /path/to/your/ndk/directory
   

   确保NDK目录下所有文件和子文件夹都拥有可读可执行权限。

2. 调整系统文件描述符限制
   Mac默认的文件描述符上限较低，并行编译时多线程同时打开文件可能触发权限/资源错误，临时调整上限试试：

   ulimit -n 10240
   

   执行后再运行编译命令，如果有效，可以把这个命令加到~/.bash_profile或~/.zshrc里（根据你使用的shell），实现永久生效。

3. 调整NDK存放路径
   确保NDK放在系统权限宽松的目录，比如默认的~/Library/Android/sdk/ndk/，不要放在Documents、Downloads这类Catalina系统隐私保护严格的目录。

4. 临时关闭系统完整性保护（SIP）测试
   虽然不推荐长期关闭，但可以临时测试是否是SIP导致的权限限制：

   • 重启Mac，按住Command+R进入恢复模式；
   • 打开终端，执行csrutil disable后重启电脑；
   • 测试编译是否正常，如果有效，再考虑是否需要配置SIP例外规则（不建议完全关闭SIP）。

内容的提问来源于stack exchange，提问作者eshwar ms