Guías Técnicas

Variables de Entorno con dotenv en Node.js y Express

¿Qué son las Variables de Entorno?

Las variables de entorno son pares de clave-valor almacenados fuera del código de la aplicación, que permiten configurar aspectos de la aplicación de manera externa y segura.

  Características Principales

  • Almacenan información sensible
  • Configuran diferentes entornos (desarrollo, producción)
  • Mejoran la seguridad del código
  • Facilitan la configuración de la aplicación

Instalación de dotenv

bash 
# Crear nuevo proyecto
mkdir dotenv-demo
cd dotenv-demo

Inicializar proyecto

bash 
npm init -y

Instalar dotenv

bash 
npm install dotenv

Configuración Básica

1Crear Archivo .env
bash 
# Archivo .env
PORT=3000
DATABASE_URL=mongodb://localhost:27017/mibasedatos
API_KEY=mi_clave_secreta_de_api
JWT_SECRET=mi_secreto_super_seguro
DEBUG=true
2Configuración en Código
javascript 
// Cargar variables de entorno al inicio de la aplicación
require('dotenv').config();

// Acceder a variables de entorno
const port = process.env.PORT || 4000;
const databaseUrl = process.env.DATABASE_URL;
const apiKey = process.env.API_KEY;

Ejemplos Prácticos

1Configuración Básica con Express
javascript 
const express = require('express');
const dotenv = require('dotenv');

// Cargar variables de entorno
dotenv.config();

const app = express();
const PORT = process.env.PORT || 3000;
const DEBUG = process.env.DEBUG === 'true';

app.get('/', (req, res) => {
  res.json({
    message: 'Aplicación funcionando',
    port: PORT,
    debugMode: DEBUG
  });
});

app.listen(PORT, () => {
  if (DEBUG) {
    console.log(`Servidor corriendo en puerto ${PORT} en modo DEBUG`);
  }
});
2Configuración de Base de Datos
javascript 
const mongoose = require('mongoose');

// Conexión a MongoDB usando variables de entorno
mongoose.connect(process.env.DATABASE_URL, {
useNewUrlParser: true,
useUnifiedTopology: true
});

const db = mongoose.connection;
db.on('error', console.error.bind(console, 'Error de conexión:'));
db.once('open', () => {
  console.log('Conectado a la base de datos');
});
3Configuración de Servicios Externos
javascript 
const axios = require('axios');

// Configuración de cliente API
const apiClient = axios.create({
baseURL: process.env.API_BASE_URL,
headers: {
  'Authorization': `Bearer ${process.env.API_KEY}`,
  'Content-Type': 'application/json'
}
});

// Ejemplo de solicitud
async function fetchData() {
try {
  const response = await apiClient.get('/datos');
  return response.data;
} catch (error) {
  console.error('Error al obtener datos:', error);
}
}

Múltiples Archivos de Configuración

1Archivos de Entorno Específicos
bash 
# .env.development
PORT=3000
DEBUG=true
DATABASE_URL=mongodb://localhost:27017/desarrollo

# .env.production
PORT=80
DEBUG=false
DATABASE_URL=mongodb://produccion-server/mibasedatos
2Carga Condicional
javascript 
// Seleccionar archivo de configuración
const environment = process.env.NODE_ENV || 'development';
require('dotenv').config({ 
path: `.env.${environment}` 
});
  Mejores Prácticas

  • Nunca commits archivos .env
  • Usa .env.example como plantilla
  • Protege archivos con información sensible

Ejemplo de .gitignore

bash 
# Archivos a ignorar
node_modules/
.env
*.log

Ejemplo de .env.example

bash 
# Plantilla de configuración
PORT=3000
DATABASE_URL=mongodb://localhost:27017/mibasedatos
API_KEY=tu_clave_api_aqui

Validación de Variables de Entorno

Código verifica si las variables de entorno necesarias (PORT, DATABASE_URL, API_KEY) están definidas en la aplicación. Si alguna de ellas falta, se muestra un mensaje de error en la consola y se detiene la ejecución del programa. Finalmente, la función validarConfiguracion se llama al inicio de la aplicación para asegurarse de que todas las configuraciones requeridas están presentes antes de continuar.

javascript 
function validarConfiguracion() {
const requiredEnvs = ['PORT', 'DATABASE_URL', 'API_KEY'];

requiredEnvs.forEach(env => {
  if (!process.env[env]) {
    console.error(`Error: Falta la variable de entorno ${env}`);
    process.exit(1);
  }
});
}

// Llamar al inicio de la aplicación
validarConfiguracion();
  Conclusión

Las variables de entorno con dotenv son fundamentales para configurar aplicaciones Node.js de manera segura y flexible, permitiendo una gestión eficiente de configuraciones entre diferentes entornos.