使用Node.js和Express实现文件下载的完整指南

const path = require('path');

// 假设文件名为 value，例如 'NiceBook.txt'
let fileNAME = value; // 从请求中获取文件名
let filePATH = path.join(__dirname, '..', '..', 'Books', fileNAME);
// 注意：如果你的下载逻辑文件与Books目录层级不同，__dirname的相对路径也需调整。
// 例如，如果下载逻辑文件在 my_project/ketabk/index.js，而Books在 my_project/ketabk/Books
// 那么路径将是 path.join(__dirname, 'Books', fileNAME);
// 原始问题中的路径 `__dirname + `/../Books/${value}`` 也是一种写法，但 path.join 更推荐。

const fs = require('fs');

if (!fs.existsSync(filePATH)) {
  return res.status(404).send("File does not exist."); // 文件不存在时返回404
}

// ... (之前的代码)

try {
  // ... (文件路径构建和存在性检查)

  res.download(filePATH, fileNAME, (error) => {
    if (error) {
      console.error(`Error during file download: ${error.message}`);
      // 检查错误是否是由于客户端中断，否则发送错误响应
      if (!res.headersSent) { // 确保响应头未发送
        return res.status(500).send("Error downloading file.");
      }
    }
    // 下载成功，回调函数通常不会收到error参数
  });
} catch (error) {
  console.error(`Server error while preparing download: ${error.message}`);
  if (!res.headersSent) {
    return res.status(500).send("Server error occurred.");
  }
}

const express = require("express");
const path = require('path');
const fs = require('fs'); // 引入fs模块用于文件存在性检查
const app = express();

// 定义一个日志记录器，这里使用简单的console.log代替
const logger = {
  info: (message, data) => console.log(`INFO: ${message}`, data || ''),
  error: (message, error) => console.error(`ERROR: ${message}`, error || ''),
};

let downloadFile = async (req, res) => {
  // 从URL查询参数中获取文件名，例如: http://localhost:3000/?path=NiceBook.txt
  const fileName = req.query.path;

  if (!fileName) {
    return res.status(400).send("Missing 'path' query parameter.");
  }

  // 构建文件的绝对路径
  // 假设你的文件存储在项目根目录下的 'Books' 文件夹中
  // 这里的 __dirname 指向当前脚本所在的目录 (例如: my_project/ketabk/index.js)
  // 如果你的Books文件夹在项目根目录，且此脚本也在根目录，则直接 path.join(__dirname, 'Books', fileName)
  // 如果此脚本在子目录 (例如: my_project/ketabk/src/routes/index.js)，而Books在 my_project/ketabk/Books
  // 则可能需要 path.join(__dirname, '..', 'Books', fileName)
  // 示例中假设 `index.js` 和 `Books` 在同一目录下
  const booksDirectory = path.join(__dirname, 'Books');
  const filePath = path.join(booksDirectory, fileName);

  logger.info(`Attempting to download file: ${filePath}`);

  try {
    // 1. 检查文件是否存在
    if (!fs.existsSync(filePath)) {
      logger.error(`File not found: ${filePath}`);
      return res.status(404).send("File does not exist.");
    }

    // 2. 使用 res.download() 发送文件
    res.download(filePath, fileName, (error) => {
      if (error) {
        // 捕获下载过程中的错误
        logger.error(`Error during file download for ${fileName}:`, error);
        // 确保响应头未发送，以避免“Cannot set headers after they are sent to the client”错误
        if (!res.headersSent) {
          return res.status(500).send("Error downloading file.");
        }
      } else {
        logger.info(`Successfully downloaded file: ${fileName}`);
      }
    });
  } catch (error) {
    // 捕获路径构建或文件存在性检查等同步操作的错误
    logger.error(`Server error while preparing download for ${fileName}:`, error);
    if (!res.headersSent) {
      return res.status(500).send("Server error occurred.");
    }
  }
};

// 设置路由
app.get('/download', downloadFile); // 更改为 /download 路由更清晰

const PORT = 3000;
app.listen(PORT, function (err) {
  if (err) {
    console.error("Server startup error:", err);
  } else {
    console.log(`Server listening on PORT ${PORT}`);
    console.log(`Try downloading: http://localhost:${PORT}/download?path=NiceBook.txt`);
    console.log(`(Make sure 'NiceBook.txt' exists in the 'Books' directory next to this script)`);
  }
});

// 为了使示例可运行，请在与此脚本同级的目录下创建一个名为 'Books' 的文件夹
// 并在 'Books' 文件夹中放入一个名为 'NiceBook.txt' 的文件
// 例如，在项目根目录创建 Books/NiceBook.txt