Node.js 18+环境下Vite server.fs文件服务功能失效求助

问题场景 #

• 原环境：Node.js 16.16.0 + Vite（底层rush+pnpm管理单体仓），通过server.fs.allow/deny配置控制文件访问，规则均正常生效
• 升级后：Node.js 18.13 + 最新版Vite，文件服务完全失效，原可正常访问的文件请求返回Error: connect ECONNREFUSED 127.0.0.1:5001
• 异常表现：即使配置deny规则，也无法返回16.x环境下的403 Restricted；控制台无报错，主机、端口配置确认无误

排查与解决方案 #

1. 调整Vite服务器的host配置 #

Node.js 18对HTTP模块的默认解析逻辑有调整，尝试显式指定server.host为127.0.0.1而非默认的localhost：

export default defineConfig({
  server: {
    host: '127.0.0.1',
    port: 5001,
    fs: {
      allow: ['/绝对路径/目标文件目录'],
      // deny: [...]
    }
  }
})

2. 确认Vite配置是否被正确加载 #

由于使用rush+pnpm单体仓，可能存在配置未正确继承的情况：

• 在Vite配置文件中添加日志输出，验证启动时server.fs配置是否正确读取：

  const viteConfig = defineConfig({
    server: { /* 你的配置 */ }
  })
  console.log('Loaded server.fs config:', viteConfig.server.fs)
  export default viteConfig
  

• 检查pnpm workspace或rush项目配置，确保Vite所在包的依赖、执行权限无异常

3. 修正文件路径配置 #

Node.js 18对文件系统权限检查更严格，注意：

• server.fs.allow必须配置绝对路径，避免相对路径在不同Node版本下解析差异
• 临时关闭fs严格模式（仅用于测试），确认是否是路径匹配问题：

  server: {
    fs: { strict: false }
  }
  

  若关闭后文件可访问，说明需要调整allow/deny的路径写法

4. 排查请求转发与插件冲突 #

ECONNREFUSED通常是请求无法连接到目标服务，尝试：

• 禁用所有非必要的Vite插件，验证是否是插件修改了请求处理流程
• 用lsof -i :5001（Mac/Linux）或netstat -ano | findstr :5001（Windows）确认端口是否被Vite进程占用

5. 调整Node.js 18版本 #

Node.js 18.13可能存在特定版本bug，尝试升级到18.x最新稳定版（如18.20）或降级到18.12，验证问题是否消失

内容的提问来源于stack exchange，提问作者L.J.