Apollo Gateway Schema合成失败：U+0130字符语法错误求助

问题重现 #

使用Apollo Federation搭建User Service和Gateway时：

• User Service单独启动后运行正常，可正常处理请求
• Gateway通过IntrospectAndCompose合成超图Schema时，抛出错误：Syntax Error: Unexpected character: U+0130
• 尝试将user.graphql文件编码改为utf16le无效，切换系统默认语言从土耳其语到英语后，Gateway可正常合成Schema

原因分析 #

U+0130是土耳其语特有的大写字母İ（带点的I），问题根源在于系统区域设置对字符串处理的影响：

• 土耳其语的大小写转换规则与英语不同：英语中i大写为I，I小写为i；但土耳其语中i大写为İ，I小写为ı
• Apollo Gateway在通过Introspection获取子图Schema并合成超图时，内部的字符串处理逻辑（如字段名、类型名的规范化）受系统区域设置（LC_CTYPE）影响，错误地将某些字符转换为土耳其语的特殊字符（U+0130），导致GraphQL解析器无法识别，抛出语法错误
• 单独运行User Service时，Schema解析过程未触发跨服务的规范化逻辑，因此未暴露该问题

解决方案 #

临时修复（已验证有效） #

切换系统默认语言为英语，避免区域设置干扰字符串处理逻辑。

永久修复 #

1. 强制Node.js使用英语区域设置
   在启动Node.js进程时，通过环境变量指定区域：

   LC_ALL=en_US.UTF-8 node gateway.js
   

   或者在代码最顶部（任何其他导入前）设置环境变量：

   process.env.LC_ALL = 'en_US.UTF-8';
   process.env.LANG = 'en_US.UTF-8';
   

2. 确保Schema文件读取的编码一致性
   保持User Service中读取Schema文件时明确指定UTF-8编码（你的代码已正确实现）：

   const typeDefs = gql(
     readFileSync("src/graphql/types/user.graphql", { encoding: "utf-8" })
   );
   

3. 避免使用受区域影响的字符
   确保Schema中的类型名、字段名仅使用英语大小写字母，避免可能触发特殊转换规则的字符。

相关代码参考 #

Gateway代码 #

import { ApolloGateway, IntrospectAndCompose } from "@apollo/gateway";
import { ApolloServer } from "@apollo/server";
import { expressMiddleware } from "@apollo/server/express4";
import { ApolloServerPluginDrainHttpServer } from "@apollo/server/plugin/drainHttpServer";
import express from "express";
import http from "http";
import { json } from "body-parser";

const startServer = async () => {
  const gateway = new ApolloGateway({
    supergraphSdl: new IntrospectAndCompose({
      subgraphs: [
        { name: "userService", url: "http://localhost:4001" }
      ],
    }),
  });

  const app = express();
  const httpServer = http.createServer(app);

  const server = new ApolloServer({
    gateway,
    plugins: [ApolloServerPluginDrainHttpServer({ httpServer })],
  });

  await server.start();

  await new Promise<void>((resolve) =>
    httpServer.listen({ port: 4000 }, resolve)
  );
  console.log(`🚀 Server ready at http://localhost:4000/graphql`);
};

startServer();

User Service代码 #

import { ApolloServer } from "@apollo/server";
import { buildSubgraphSchema } from "@apollo/subgraph";
import gql from "graphql-tag";
import { resolvers } from "./graphql/resolver";
import { startStandaloneServer } from "@apollo/server/standalone";
import { readFileSync } from "fs";
const mongoose = require("mongoose");
const typeDefs = gql(
  readFileSync("src/graphql/types/user.graphql", { encoding: "utf-8" })
);

import { DB_URI } from "../database-config";

require("dotenv").config();

const createDatabaseConnection = async () => {
  try {
    await mongoose.connect(DB_URI);
    console.log("User Service: Connected to DB");
  } catch (error) {
    console.log(error);
  }
};

const startUserServiceServer = async () => {
  const server = new ApolloServer({
    schema: buildSubgraphSchema({ typeDefs, resolvers }),
  });

  await createDatabaseConnection();

  const { url } = await startStandaloneServer(server, {
    listen: { port: 4001 },
  });

  console.log(`User Service: Server ready at ${url}`);
};

startUserServiceServer();

user.graphql #

extend schema
  @link(url: "https://specs.apollo.dev/federation/v2.0", import: ["@key"])

type Query {
  me: User
}

type Mutation {
  addUser(fields: UserInput): User
  updateUser(fields: UserInput): User
}

type User @key(fields: "id") {
  id: ID
  fullName: String
  phone: String
  avatarURL: String
  password: String
  email: String
  address: String
  createdAt: String
  updatedAt: String
}

input UserInput { 
  id: ID
  fullName: String
  phone: String
  avatarURL: String
  password: String
  email: String
  address: String
}

内容的提问来源于stack exchange，提问作者Ertan Özdemir