求助：Gatsby项目因spaceId与accessToken未定义导致Contentful连接失败无法开发

你遇到的核心问题是Gatsby没有正确读取到配置的Contentful环境变量，导致插件初始化失败。我整理了几个常见的排查和解决步骤，你可以逐一尝试：

• 确认.env文件的位置和命名
  确保你的环境变量文件（开发环境通常用.env.development，构建用.env.production）放在项目根目录，和gatsby-config.js处于同一层级。注意文件名开头的.，部分操作系统会隐藏这类文件，你可以用终端命令ls -a（Mac/Linux）或开启文件夹的“显示隐藏文件”选项来确认它存在。

• 检查.env文件的内容格式
  环境变量的定义不能加引号，也不要在等号前后加空格，正确格式如下：

  CONTENTFUL_SPACE_ID=你的SpaceID字符串
  CONTENTFUL_ACCESS_TOKEN=你的Access令牌字符串
  

  格式错误会导致Gatsby无法解析这些变量。

• 验证gatsby-config.js中的变量引用
  打开gatsby-config.js，确认插件配置通过process.env读取变量，示例代码：

  module.exports = {
    plugins: [
      {
        resolve: `gatsby-source-contentful`,
        options: {
          spaceId: process.env.CONTENTFUL_SPACE_ID,
          accessToken: process.env.CONTENTFUL_ACCESS_TOKEN,
          // 保留默认配置如environment: "master"即可
        },
      },
      // 其他插件配置...
    ],
  };
  

  如果你手动使用dotenv包，要在配置文件最顶部加载它：

  require('dotenv').config({ path: `.env.${process.env.NODE_ENV}` });
  

  （注：Gatsby v2及以上版本会自动加载根目录的.env文件，自定义路径时才需要手动配置）

• 重启开发服务器
  环境变量修改不会实时生效，你需要停止当前的gatsby develop进程，重新启动后新的环境变量才会被加载。

• 排查环境变量是否真的被加载
  可以在gatsby-config.js顶部添加临时日志，打印环境变量值：

  console.log("加载的Space ID:", process.env.CONTENTFUL_SPACE_ID);
  console.log("加载的Access Token:", process.env.CONTENTFUL_ACCESS_TOKEN);
  

  运行gatsby develop后查看终端输出，如果仍显示undefined，说明.env文件未被正确读取，可能是位置、命名或权限问题。

• 检查仓库克隆后的.env文件
  如果你是从GitHub克隆的项目，.env文件通常会被加入.gitignore，不会同步到仓库。新电脑上需要重新创建.env文件，并填入正确的Contentful密钥。

按照这些步骤排查后，应该能解决环境变量未被读取的问题，让gatsby-source-contentful插件正常初始化。

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