Node.js：如何让getFileExists从项目根/源码目录检查及获取uploads路径

问题说明 #

• 编写的getFileExists函数，预期路径相对于调用它的文件（比如从/project/src/routes/file.ts调用时检查src/routes目录），但实际测试发现路径是基于项目根目录进行检查
• getRootPath函数逻辑存在硬编码判断，无法准确获取public目录路径
• 需要获取项目根目录下uploads目录的正确路径，确保文件检查和路径获取能稳定基于项目根目录或源码目录

现有代码 #

getFileExists 函数 #

export function getFileExists(path): boolean {
   var fileExists: boolean = false;

   try {
     fileExists = fs.existsSync(path);
   } catch (error) { }

   return fileExists;
}

存在问题的 getRootPath 函数 #

export function getRootPath() {
  var rootPath = path.join(__dirname, "../public");
  if (__dirname.indexOf("/folder1/folder2/")==0) {
    rootPath = path.join(__dirname, "../../public");
  }
  return rootPath;
}

Express 静态资源配置 #

app.use(express.static('public'));
app.use(express.static('uploads'));

解决方案 #

1. 稳定获取项目根目录 #

Node.js 中有两种可靠方式获取项目根目录：

• process.cwd()：返回启动 Node.js 进程时所在的目录，也就是你的项目根目录（只要你是在项目根下执行启动命令）
• path.dirname(require.main.filename)：如果通过node命令直接启动入口文件，这个会返回入口文件所在的目录（通常就是项目根）

推荐优先使用process.cwd()，除非你的启动方式特殊。

2. 重构 getRootPath 函数 #

基于项目根目录直接生成public和uploads的绝对路径，避免硬编码层级判断：

import path from 'path';

export function getRootPath() {
  const projectRoot = process.cwd();
  return path.join(projectRoot, 'public');
}

// 新增获取 uploads 目录路径的函数
export function getUploadsPath() {
  const projectRoot = process.cwd();
  return path.join(projectRoot, 'uploads');
}

3. 修正 getFileExists 函数 #

使用绝对路径进行文件检查，避免相对路径的歧义：

import fs from 'fs';
import path from 'path';

export function getFileExists(filePath): boolean {
  const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(process.cwd(), filePath);
  
  try {
    return fs.statSync(absolutePath).isFile();
  } catch (error) {
    return false;
  }
}

4. 调整 Express 静态资源配置 #

使用绝对路径配置静态资源，避免因启动目录变化导致的路径错误：

import path from 'path';

const projectRoot = process.cwd();
app.use(express.static(path.join(projectRoot, 'public')));
app.use(express.static(path.join(projectRoot, 'uploads')));

关键说明 #

• 绝对路径永远比相对路径更可靠，尤其是在多人协作或部署环境中
• 不要依赖__dirname的层级计算，因为文件结构变化时会直接导致路径错误
• fs.existsSync已被官方建议逐步替代，使用fs.statSync能更准确判断文件状态

内容的提问来源于stack exchange，提问作者1.21 gigawatts