Windows环境下Node.js的dotenv无法读取.env文件导致OAuth2Strategy缺少clientID报错

我之前在Windows下开发Node.js项目时，也踩过一模一样的dotenv不生效的坑，结合你给出的报错信息和场景，给你梳理下具体的解决步骤：

问题重现 #

运行npm run server时触发以下报错，且console.log(process.env.GOOGLE_CLIENT_ID)输出undefined：

TypeError: OAuth2Strategy requires a clientID option
    at Strategy.OAuth2Strategy (C:\Users\user\Desktop\NexoGame-b\node_modules\passport-oauth2\lib\strategy.js:87:34)
    at new Strategy (C:\Users\user\Desktop\NexoGame-b\node_modules\passport-google-oauth20\lib\strategy.js:52:18)
    at file:///C:/Users/user/Desktop/NexoGame-b/config/passport.js:6:3
    ...
[nodemon] app crashed - waiting for file changes before starting...

根因分析 #

这是Windows文件资源管理器的「隐形坑」：当你手动创建.env文件时，系统会默认给这类以点开头的文件添加隐藏扩展名（比如.env.txt、.env.3dsenv），但dotenv包只会严格读取无任何后缀的.env文件，导致环境变量加载失败，最终OAuth2策略因缺少必要的clientID参数崩溃。

具体解决步骤 #

1. 确认.env文件的真实名称 #

首先要搞清楚你的文件到底叫什么：

• 图形界面方式：打开文件资源管理器，切换到项目根目录，点击顶部「查看」选项卡，勾选「文件扩展名」（显示所有文件的后缀），此时就能看到.env文件的真实名称（比如.env.txt）。
• 命令行更稳妥：在项目根目录打开PowerShell，执行以下命令：

  Get-ChildItem -Name "*.env*"
  

  命令会列出所有带.env关键字的文件，你能直接看到真实文件名。

2. 重命名为正确的.env文件 #

• 图形界面：右键点击该文件，选择「重命名」，删除多余的后缀（比如把.env.txt改成.env），Windows会弹出「更改文件扩展名可能会导致文件不可用」的提示，点击「是」确认即可。
• 命令行方式（避免图形界面的异常）：在PowerShell中执行重命名命令，把.env.txt替换为你查到的真实文件名：

  Rename-Item -Path ".env.txt" -NewName ".env"
  

3. 确保dotenv在代码中优先加载 #

在你的server.js中，一定要把dotenv.config()放在最顶部，确保在加载任何依赖环境变量的模块（比如passport配置）之前完成环境变量加载：

// 第一步：加载环境变量
import dotenv from 'dotenv';
dotenv.config();

// 第二步：再导入其他依赖模块
import './config/passport.js';
import express from 'express';

// 验证加载结果
console.log("已加载环境变量，GOOGLE_CLIENT_ID：", process.env.GOOGLE_CLIENT_ID);

4. 额外排查点 #

• 确认.env文件位于项目根目录（和server.js同级），dotenv默认从当前工作目录查找该文件；
• 检查.env文件的格式：变量名和值之间不要加空格，不要给值加引号，比如正确格式：

  GOOGLE_CLIENT_ID=your_actual_client_id_here
  GOOGLE_CLIENT_SECRET=your_actual_client_secret_here
  

• 如果使用ES模块（代码中用import），无需额外配置，dotenv.config()即可正常工作，若文件位置特殊可指定路径：dotenv.config({ path: './.env' })

验证修复效果 #

重启你的服务（nodemon会自动检测文件变化重启，或者手动执行node server.js），如果console.log能正确输出GOOGLE_CLIENT_ID的值，说明环境变量加载成功，OAuth2Strategy的报错也会随之消失。

内容来源于stack exchange