将当前 shell 环境变量传递给 Node 应用程序

70次阅读

问题描述

在运行位于 Ubuntu 上的 Node 应用程序时，用户遇到了将变量传递给 Node 应用程序的问题。用户的 package.json 文件包含以下内容：

{
  "scripts": {
    "start": "node index.js"
  }
}

应用程序通过命令 npm run start 启动。用户的问题在于，尽管他已经在 shell 中导出了大量的环境变量，并且可以通过 echo $MY_VAR 验证这些变量在 shell 中可用，但在启动应用程序后，从 process.env.MY_VAR 获取的结果却是 undefined。

解决方案

请注意以下操作可能因版本差异而有所不同，同时在操作前建议做好备份。

方案1

正确地将当前 shell 环境变量传递给 Node 应用程序需要确保变量在启动应用程序的子进程环境中可见。以下是一种解决方法：

导出环境变量：首先，确保你已在当前 shell 中正确导出了所有需要的环境变量。你可以通过运行类似于 export MY_VAR=value 的命令来导出变量。
更新 npm 脚本：在你的 package.json 文件中，将启动命令修改为使用 env 命令来启动 Node 应用程序，并将环境变量传递给子进程。更新 start 脚本如下：
json { "scripts": { "start": "env node index.js" } }
重新启动应用程序：保存更新后的 package.json 文件，并重新运行 npm run start 启动应用程序。现在，应用程序应该能够正确地访问你在当前 shell 中导出的环境变量。

这样做的关键是使用 env 命令来在启动 Node 应用程序之前将环境变量传递给子进程。这样，你的应用程序将能够访问到正确的环境变量值。

方案2

如果你想要更加灵活地管理环境变量，可以考虑使用专门的环境变量管理工具，如 dotenv。这个工具可以帮助你从文件中加载环境变量，并将它们注入到应用程序中。以下是一些步骤：

安装 dotenv：在项目目录下运行以下命令来安装 dotenv：
sh npm install dotenv
创建 .env 文件：在项目目录下创建一个名为 .env 的文件，并在其中按以下格式添加你的环境变量：
plaintext MY_VAR=value ANOTHER_VAR=another_value
在应用程序中使用 dotenv：在你的 Node 应用程序的入口文件（通常是 index.js）的顶部添加以下代码，以加载 .env 文件中的环境变量：
javascript require('dotenv').config();
访问环境变量：现在，你可以通过 process.env 对象访问在 .env 文件中定义的环境变量。例如，你可以通过 process.env.MY_VAR 来获取 MY_VAR 的值。

使用 dotenv 可以更方便地管理和加载环境变量，特别是当你需要在不同的环境中运行应用程序时。

方案3

另一种方法是编写一个简单的 bash 脚本，该脚本会先启动应用程序之前等待环境变量生效。以下是一个示例脚本：

#!/bin/bash
# 导出所需的环境变量
export MY_VAR=value

# 等待环境变量生效
while [ -z "$MY_VAR" ]; do
  sleep 1
done

# 启动 Node 应用程序
node index.js

在这个示例中，我们首先在脚本中导出了需要的环境变量。然后，使用一个循环来等待环境变量生效，直到变量的值不再为空。一旦环境变量生效，就会启动 Node 应用程序。

方案4

使用 Supervisor 等工具可能会在一定程度上增加系统的复杂性，请在使用之前进行充分的测试。

另一种方法是使用进程管理工具，如 Supervisor，来启动和监控 Node 应用程序。这些工具可以帮助你管理应用程序的生命周期，包括环境变量的传递。以下是使用 Supervisor 的步骤：

安装 Supervisor：在系统中安装 Supervisor：
sh npm install -g supervisor
启动应用程序：使用 Supervisor 命令来启动你的 Node 应用程序，并通过 -e 参数将环境变量传递给应用程序：
sh supervisor -e MY_VAR=value index.js