REST API开发：同类功能路由应独立控制器还是合并？

你当前的场景是：网站有蔬菜、水果两类产品，对应三组功能相似的路由，但复用控制器时觉得逻辑和路由管理混乱，纠结该给每个路由做独立控制器，还是继续合并复用部分控制器。下面分两种方案分析，并给出选择依据：

一、独立控制器方案 #

给每个路由单独编写对应控制器，比如：

// 蔬菜专属控制器
const getAllVegProducts = () => {}
const getVegProduct = () => {}
const getVegRecommendedProducts = () => {}

// 水果专属控制器
const getAllFruitsProducts = () => {}
const getFruitProduct = () => {}
const getFruitsRecommendedProducts = () => {}

路由配置直接一一对应：

// 蔬菜路由
router.get('/products/veg', getAllVegProducts)
router.get('/products/veg/:id', getVegProduct)
router.get('/products/veg/rec', getVegRecommendedProducts)

// 水果路由
router.get('/products/fruits', getAllFruitsProducts)
router.get('/products/fruits/:id', getFruitProduct)
router.get('/products/fruits/rec', getFruitsRecommendedProducts)

优缺点 #

• 优势：每个控制器职责单一，逻辑一目了然；后续某类产品要加特殊规则（比如蔬菜过滤有机标签、水果按甜度排序），直接改对应控制器就行，不会影响另一类；路由和控制器的对应关系清晰，新人接手快。
• 劣势：初期会有重复代码，如果两类产品逻辑完全一致，会造成冗余；后续修改通用逻辑时，要改多个控制器，容易遗漏。

二、合并复用控制器方案 #

优化现有复用逻辑，不是把两类逻辑硬塞到一个控制器，而是通过路由参数传递产品类型，让控制器根据参数区分处理。

先改造路由，把产品类型提取为统一参数：

// 统一路由结构，兼容所有产品分类
router.get('/products/:category', getAllProducts)
router.get('/products/:category/:id', getProduct)
router.get('/products/:category/rec', getProductsRecomended)

再修改控制器，从请求中获取category参数，执行对应逻辑：

// 通用全量产品控制器
const getAllProducts = (req, res) => {
  const { category } = req.params;
  // 根据分类调用业务逻辑（比如从对应数据库表查询）
  const products = getProductsFromDB(category);
  res.json(products);
};

// 通用单产品控制器
const getProduct = (req, res) => {
  const { category, id } = req.params;
  const product = getSingleProductFromDB(category, id);
  res.json(product);
};

// 通用推荐产品控制器
const getProductsRecomended = (req, res) => {
  const { category } = req.params;
  const recommendedProducts = getRecommendedProductsFromDB(category);
  res.json(recommendedProducts);
};

如果有通用逻辑，可以抽成公共函数进一步复用：

// 公共函数：处理产品查询的通用逻辑（分页、排序等）
const fetchProducts = (category, filter = {}) => {
  return db.query(`SELECT * FROM ${category} WHERE ?`, filter);
};

// 控制器调用公共函数
const getAllProducts = (req, res) => {
  const { category } = req.params;
  const products = fetchProducts(category);
  res.json(products);
};

优缺点 #

• 优势：代码复用率高，通用逻辑只写一次；新增同类产品（比如肉类）时，不用重复写控制器，直接兼容路由；修改通用规则（比如统一加分页参数），只需要改公共函数。
• 劣势：如果某类产品需要特殊逻辑，控制器里会出现大量if/else判断，导致代码臃肿，维护成本上升：

const getAllProducts = (req, res) => {
  const { category } = req.params;
  let products = fetchProducts(category);
  if (category === 'veg') {
    // 蔬菜特殊逻辑：过滤有机产品
    products = products.filter(p => p.isOrganic);
  } else if (category === 'fruits') {
    // 水果特殊逻辑：按甜度排序
    products = products.sort((a,b) => b.sweetness - a.sweetness);
  }
  res.json(products);
};

三、选择依据 #

核心看两类产品的业务差异度和未来扩展需求：

• 如果蔬菜和水果的逻辑几乎完全一致，未来也不会有太多差异化需求：选合并复用控制器，但要做好参数化设计，把通用逻辑抽离到公共函数，避免控制器堆逻辑。
• 如果两类产品已经有明显差异化逻辑，或者未来肯定会有不同业务规则：选独立控制器，虽然初期有重复代码，但后续维护更清晰，不会因为修改一类产品影响另一类。
• 折中方案：如果大部分逻辑通用，只有小部分差异化，可以先复用控制器，把差异化逻辑抽成单独的处理函数，既保留复用性，又隔离特殊逻辑，避免控制器臃肿。

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