如何在安卓10 Termux中运行React Native项目及解决npm权限报错
问题根因
该报错并非常规的文件权限不足导致。安卓设备的公共共享存储分区(路径为/storage/emulated/0/)采用FUSE文件系统实现,本身不支持创建*符号链接(symlink)*操作。npm在安装依赖时,需要在node_modules/.bin目录下为所有可执行依赖创建大量软链接,这类操作在公共存储分区下会被操作系统直接拒绝,即使切换root用户执行安装命令,依然会触发同类报错。
分步解决操作
1. 迁移项目到支持Linux标准操作的目录
- 优先选择Termux的私有家目录(绝对路径
/data/data/com.termux/files/home)存放项目代码,该目录运行在ext4文件系统上,完全支持symlink创建、权限管控等Linux标准操作,适配Node生态的运行要求。 - 具体执行命令:
- 拷贝原项目到Termux家目录:
cp -r /storage/emulated/0/lightBag_ExpoVersion2 ~/ - 删除拷贝路径下残留的旧
node_modules目录(公共存储下生成的无效残留文件会引发后续编译异常):rm -rf ~/lightBag_ExpoVersion2/node_modules - 进入迁移后的项目目录:
cd ~/lightBag_ExpoVersion2 - 重新执行依赖安装:
npm install
- 拷贝原项目到Termux家目录:
2. 配置Termux的跨存储访问映射
项目迁移到Termux私有目录后,无需为了读写公共存储文件把项目移回公共分区,只需一次性配置存储映射:
- 在Termux终端执行:
termux-setup-storage - 按照系统弹窗提示允许Termux的文件访问权限,执行完成后Termux家目录下会自动生成
storage软链接,映射到安卓的图片、下载、文档等公共存储路径,需要读写公共文件时通过该软链接访问即可。
3. 配置React Native/Expo项目运行环境
- 先执行基础环境更新:
pkg update && pkg upgrade -y,再安装项目运行必需的基础依赖:pkg install nodejs python openjdk-17 -y - 严禁在公共存储目录下启动Metro打包服务,Metro本身依赖文件系统监听、symlink操作,在公共存储下会出现服务启动失败、热更新失效、文件识别异常等问题。
- 依赖安装完成后,在项目目录下执行
npx expo start即可正常启动开发服务,搭配设备端的Expo Go应用扫码就能完成项目的调试与运行。
临时兜底方案(不推荐长期使用)
如果暂时无法迁移项目目录,可在执行npm install时添加参数跳过bin目录的symlink创建流程:npm install --no-bin-links。该方案的缺陷是依赖包对应的CLI命令无法正常调用,仅能作为临时测试使用,长期开发仍需将项目放置在Termux私有可执行目录下。
内容的提问来源于stack exchange,提问作者Jishnu Baruah
相关产品推荐
相关产品推荐

