Apollo GraphQL项目Resolver与TypeDef文件夹结构最佳实践及导出歧义问题解决

你遇到的问题很典型——当多个Resolver文件都导出同名的resolvers对象时，直接export *会触发命名冲突错误。下面我会分享三种最优解决方案，既能保持每个TypeDef对应独立Resolver文件的结构，又能让入口文件只用一行代码导入合并后的resolvers。

方案一：自定义命名导出 + 手动合并（适合小型项目） #

这个方案思路直接：给每个Resolver文件的导出对象起一个和类型对应的名字，然后在index.ts里手动合并成最终的resolvers对象。

步骤1：修改单个Resolver文件的导出 #

比如Category.ts：

// src/graphql/resolvers/Category.ts
export const categoryResolvers = {
  Query: {
    getCategories: () => {
      // 你的查询逻辑
    }
  },
  Mutation: {
    createCategory: () => {
      // 你的 mutation 逻辑
    }
  },
  // 如果有Category类型的字段解析器（比如关联Product）
  Category: {
    products: (parent) => {
      // 字段解析逻辑
    }
  }
};

Product.ts同理：

// src/graphql/resolvers/Product.ts
export const productResolvers = {
  Query: {
    getProducts: () => {
      // 你的查询逻辑
    }
  },
  // ...其他 resolver 逻辑
};

步骤2：在index.ts中合并所有Resolver #

// src/graphql/resolvers/index.ts
import { categoryResolvers } from './Category';
import { productResolvers } from './Product';

export const resolvers = {
  // 合并Query类型的所有 resolver
  Query: {
    ...categoryResolvers.Query,
    ...productResolvers.Query
  },
  // 合并Mutation类型的所有 resolver
  Mutation: {
    ...categoryResolvers.Mutation,
    ...productResolvers.Mutation
  },
  // 合并自定义类型的字段解析器（比如Category、Product）
  ...categoryResolvers,
  ...productResolvers
};

这样你的入口文件src/index.ts里的import {resolvers} from "./graphql/resolvers/index"就能正常工作，而且每个Resolver的职责清晰，手动合并也能避免意外覆盖。

方案二：默认导出 + 自动合并函数（适合中大型项目） #

如果你的项目会不断新增Resolver类型，手动合并会变得繁琐。可以用默认导出配合一个自动合并函数，新增Resolver时只需要在数组里添加即可。

步骤1：修改单个Resolver文件为默认导出 #

// src/graphql/resolvers/Category.ts
export default {
  Query: {
    getCategories: () => {/* ... */}
  },
  // ...其他 resolver 逻辑
};

步骤2：在index.ts中实现自动合并 #

// src/graphql/resolvers/index.ts
import categoryResolvers from './Category';
import productResolvers from './Product';

// 通用合并函数：自动合并Query、Mutation和自定义类型
const mergeResolvers = (resolversList: Record<string, any>[]) => {
  return resolversList.reduce((merged, current) => {
    // 合并Query
    merged.Query = { ...merged.Query, ...current.Query };
    // 合并Mutation
    merged.Mutation = { ...merged.Mutation, ...current.Mutation };
    // 合并自定义类型（排除Query和Mutation）
    Object.keys(current).forEach(key => {
      if (key !== 'Query' && key !== 'Mutation') {
        merged[key] = { ...merged[key], ...current[key] };
      }
    });
    return merged;
  }, { Query: {}, Mutation: {} });
};

// 导出合并后的resolvers
export const resolvers = mergeResolvers([categoryResolvers, productResolvers]);

以后新增User.ts这类Resolver文件，只需要导入它并添加到mergeResolvers的数组里就行，不需要手动写合并逻辑，非常高效。

方案三：保留原有导出 + 重命名导入（适合已有项目迁移） #

如果你不想修改现有的Resolver文件（比如已经有很多文件都导出了resolvers），可以在index.ts里通过重命名导入来解决冲突，再合并成最终对象。

步骤1：保持单个Resolver文件的原有导出 #

// src/graphql/resolvers/Category.ts
export const resolvers = {
  Query: { getCategories: () => {/* ... */} },
  // ...其他逻辑
};

步骤2：在index.ts中重命名并合并 #

// src/graphql/resolvers/index.ts
import { resolvers as categoryResolvers } from './Category';
import { resolvers as productResolvers } from './Product';

export const resolvers = {
  Query: {
    ...categoryResolvers.Query,
    ...productResolvers.Query
  },
  Mutation: {
    ...categoryResolvers.Mutation,
    ...productResolvers.Mutation
  },
  ...categoryResolvers,
  ...productResolvers
};

这个方案零改动原有Resolver文件，快速解决冲突，适合需要快速修复问题的场景。

总结推荐 #

• 小型项目：优先选方案一，清晰直观，易于维护。
• 中大型项目：优先选方案二，减少重复工作，扩展性更好。
• 已有项目迁移：选方案三，成本最低，快速解决冲突。

不管选哪个方案，你的入口文件src/index.ts里的导入代码都不需要改动，依然可以用一行import {resolvers} from "./graphql/resolvers/index"完成导入。

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