NestJS+GraphQL中i18n翻译无法正常加载问题排查

核心问题定位 #

你的问题根源在于翻译文件未被正确加载，导致getSupportedLanguages()返回空数组，进而翻译功能失效。以下是针对性排查方案：

分步排查与解决 #

1. 验证路径解析是否正确 #

先确认join(__dirname, '/i18n/')是否指向真实存在的目录。在app.module.ts的useFactory中打印路径：

useFactory: () => {
  const i18nPath = join(__dirname, '/i18n/');
  console.log('i18n文件路径:', i18nPath); // 检查输出是否为类似 /your-project/src/i18n/
  return {
    fallbackLanguage: 'en',
    loader: I18nJsonLoader,
    loaderOptions: {
      path: i18nPath,
      watch: true,
    },
  };
},

• 如果路径错误：生产环境下__dirname指向dist目录，需改为join(process.cwd(), 'dist/i18n/')，同时确保构建时i18n文件夹被复制到dist。
• 如果路径正确，继续下一步。

2. 检查翻译文件命名规范 #

nestjs-i18n的JSON Loader默认要求文件名使用小写语言代码，将你的pt-BR.json重命名为pt-br.json，同时代码中统一使用小写标识（比如拦截器默认lang改为'pt-br'）。

3. 确保正确导入I18nJsonLoader #

检查app.module.ts是否导入了I18nJsonLoader，没有导入会导致loader无效：

import { I18nModule, I18nJsonLoader } from 'nestjs-i18n';

4. 验证i18n模块初始化状态 #

在AppModule中添加初始化钩子，直接检查翻译加载情况：

import { Module, OnModuleInit } from '@nestjs/common';
import { I18nService } from 'nestjs-i18n';

@Module({ /* 现有配置 */ })
export class AppModule implements OnModuleInit {
  constructor(private readonly i18nService: I18nService) {}

  async onModuleInit() {
    console.log('已加载语言:', this.i18nService.getSupportedLanguages());
    console.log('en翻译内容:', await this.i18nService.getTranslations('en'));
  }
}

如果这里仍输出空数组，说明模块配置存在根本性错误（比如loader未生效、路径错误）。

5. 拦截器中正确获取语言（利用官方Resolver） #

不要手动从header提取语言，改用I18nContext匹配你配置的resolvers逻辑：

// 在translate.interceptor.ts中导入
import { I18nContext } from 'nestjs-i18n';

// 修改intercept方法中的语言获取逻辑
const i18n = I18nContext.current(context);
const lang = i18n?.lang || 'pt-br';

这样能确保语言标识与加载的翻译文件完全匹配。

6. 启用Debug模式追踪加载日志 #

在i18n配置中开启debug模式，会输出详细的文件加载日志：

useFactory: () => ({
  fallbackLanguage: 'en',
  loader: I18nJsonLoader,
  loaderOptions: {
    path: join(__dirname, '/i18n/'),
    watch: true,
  },
  debug: true, // 新增该行
}),

启动应用后，控制台会显示翻译文件的加载成功/失败状态，快速定位问题。

7. 确认拦截器已注册 #

确保TranslateInterceptor已全局注册或在目标模块中注册：

// app.module.ts的providers数组中添加
providers: [
  {
    provide: APP_INTERCEPTOR,
    useClass: TranslateInterceptor,
  },
],

针对你的疑问的直接解答 #

1. 翻译无法加载的原因：最可能是翻译文件命名不符合小写规范、未正确导入I18nJsonLoader、路径解析错误这三者之一。
2. 验证翻译文件加载：通过AppModule的onModuleInit钩子打印getSupportedLanguages()和getTranslations()，或启用i18n的debug模式查看加载日志。
3. 路径解析问题：打印join后的路径确认是否指向目标目录，生产环境需注意__dirname指向dist而非src。

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