Linux下Vite项目.vite文件夹突发root权限文件致权限报错

问题核心 #

Ubuntu 24 + Node.js 20.14环境下的Vite项目，运行6个月后频繁出现EACCES: permission denied错误，触发场景为执行npm run dev时Vite触发依赖重优化，报错文件位于node_modules/.vite/deps/下，涉及axios、lodash、ckeditor等依赖，文件被意外设为root用户所有、权限400，普通用户无法修改/删除。手动修改权限后可恢复，但隔2-3天会复发，且从未使用root身份操作项目。

排查与解决步骤 #

1. 检查npm全局权限配置 #

如果之前用sudo执行过npm全局安装（比如sudo npm install -g ...），可能导致npm缓存或部分进程以root身份运行，进而污染项目文件权限：

• 检查npm全局安装目录权限：

  npm config get prefix
  # 查看输出目录的权限，比如/usr/local，执行：
  ls -ld $(npm config get prefix)
  

• 如果全局目录归root所有，修改为当前用户：

  sudo chown -R $USER:$USER $(npm config get prefix)
  

2. 清理缓存并重建依赖 #

缓存损坏可能导致权限异常，彻底清理后重建依赖：

• 清理npm缓存：

  npm cache clean --force
  

• 删除Vite本地缓存和node_modules：

  rm -rf node_modules/.vite
  rm -rf node_modules
  rm package-lock.json
  npm install
  

3. 自定义Vite缓存目录 #

将Vite的依赖优化缓存从node_modules/.vite移至项目内用户可控的目录，避免node_modules目录的权限冲突：
在项目根目录的vite.config.js中添加配置：

import { defineConfig } from 'vite'

export default defineConfig({
  cacheDir: './.vite-local-cache', // 自定义缓存目录，脱离node_modules
  // 其他原有配置...
})

修改后删除原node_modules/.vite目录，重新执行npm run dev。

4. 排查系统后台进程 #

检查是否有系统级工具在后台修改文件权限：

• 查看是否有自动更新服务、杀毒软件（比如ClamAV）、文件同步工具（如Nextcloud、Dropbox）在监控项目目录，这些工具可能以root身份运行，误改文件权限；
• 检查系统日志（/var/log/syslog），搜索涉及项目目录的权限变更记录，定位异常进程。

5. 验证Node.js安装权限 #

如果Node.js是通过sudo安装（比如直接apt安装或sudo用nvm），可能导致进程权限异常：

• 如果使用nvm，确保nvm是用普通用户安装的（不要sudo），重新切换Node版本：

  nvm use 20.14
  

• 如果是apt安装的Node，修改全局模块目录权限：

  sudo chown -R $USER:$USER /usr/lib/node_modules
  

内容的提问来源于stack exchange，提问作者Alex Smirnoff