Azure部署GraphQL-CLI创建的Node.js Graph-API时相对路径异常问题

我之前部署GraphQL应用到Azure时也碰到过一模一样的路径问题——本地跑起来顺得不行，一上Azure就报错。核心原因其实是本地和Azure的工作目录、文件结构解析逻辑不一样，咱们一步步来搞定：

1. 用绝对路径替代相对路径（最有效方案） #

本地运行时，npm start的工作目录就是你的项目根目录，所以./src/schema.graphql这种相对路径能正常找到文件，但Azure Web App的工作目录可能不是你预期的位置（比如默认是site/wwwroot），导致相对路径失效。

解决办法是用Node.js的path模块生成绝对路径，不管在哪种环境下都能精准定位文件：

首先引入path模块：

const path = require('path');

然后修改你的GraphQLServer初始化代码：

const server = new GraphQLServer({
  // 用path.join拼接__dirname（当前脚本所在目录）和相对路径，生成绝对路径
  typeDefs: path.join(__dirname, './src/schema.graphql'),
  resolvers,
  context: req => ({
    ...req,
    db: new Prisma({
      typeDefs: path.join(__dirname, 'src/generated/prisma.graphql'),
      endpoint: 'xxx',
      secret: 'xxx',
      debug: true,
    }),
  }),
})

__dirname是Node.js的内置变量，代表当前执行脚本所在的目录，用它拼接出来的绝对路径不会受工作目录影响，这应该能解决大部分路径问题。

2. 检查Azure的部署配置 #

如果用绝对路径还是不行，得确认部署后的文件结构和启动命令是否正确：

• 查看部署后的文件结构：打开Azure门户的Web App，进入「高级工具」（Kudu），地址是https://<你的WebApp名称>.scm.azurewebsites.net/，然后点击「Debug console」→「CMD」，浏览site/wwwroot目录，确认src/schema.graphql和src/generated/prisma.graphql是否存在，路径是否和本地一致。
• 确认启动命令：在Web App的「配置」→「通用设置」里，检查「启动命令」是否正确。比如如果你的入口文件是src/index.js，启动命令可以设为node src/index.js，而不是只写npm start（有时候npm start的工作目录可能不对）。

3. 优化Prisma配置（额外建议） #

另外，把Prisma的endpoint和secret硬编码在代码里不太安全，也不利于环境切换。建议用Azure的环境变量来存储这些敏感信息：

1. 在Azure Web App的「配置」→「应用程序设置」里添加两个变量：PRISMA_ENDPOINT和PRISMA_SECRET，值分别填你的实际地址和密钥。
2. 修改代码读取环境变量：

db: new Prisma({
  typeDefs: path.join(__dirname, 'src/generated/prisma.graphql'),
  endpoint: process.env.PRISMA_ENDPOINT,
  secret: process.env.PRISMA_SECRET,
  debug: true,
}),

这样本地可以用.env文件存这些变量，Azure用平台配置，不用改代码就能切换环境。

按照上面的步骤来，应该就能解决Azure上的路径问题了。

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