解决 SQL Server 的 Dockerized App getaddrinfo ENOTFOUND 错误

使用 SQL Server 处理 Docker 化应用程序连接错误

Node.js 与 Docker - 使用环境变量和网络配置

// Backend Script: Connecting to SQL Server with Environment Variables
// This solution leverages environment variables to configure database access in Node.js.
// Ensure that Docker Compose or Dockerfile properly defines network aliases for your services.
// Test each component in both local and containerized environments.

const sql = require('mssql');
require('dotenv').config();

// Configuration options using environment variables for reusability and security.
const config = {
    user: process.env.DB_USER,
    password: process.env.DB_PASS,
    server: process.env.DB_HOST || 'name_server', // Host alias as set in Docker network
    database: process.env.DB_NAME,
    options: {
        encrypt: true, // For secure connections
        trustServerCertificate: true // Self-signed certificates allowed for dev
    }
};

// Function to connect and query the database
async function connectDatabase() {
    try {
        await sql.connect(config);
        console.log("Database connection established successfully.");
    } catch (err) {
        console.error("Connection failed:", err.message);
    }
}

connectDatabase();

使用 Docker Compose 处理 SQL Server 连接的网络问题

Docker Compose - Node.js 和 SQL Server 的多容器设置

# This Docker Compose file defines two services: app (Node.js) and db (SQL Server)
# The app uses the db's container alias for network resolution.

version: '3.8'
services:
  app:
    build: .
    environment:
      - DB_USER=${DB_USER}
      - DB_PASS=${DB_PASS}
      - DB_HOST=db < !-- Alias used here -->
      - DB_NAME=${DB_NAME}
    depends_on:
      - db
  db:
    image: mcr.microsoft.com/mssql/server
    environment:
      - ACCEPT_EULA=Y
      - SA_PASSWORD=${DB_PASS}
    ports:
      - "1433:1433"

使用单元测试测试连接

Jest - 单元测试数据库连接

// Test Script: Unit test to verify connection handling in multiple environments
const sql = require('mssql');
const config = require('./config'); // Config from environment setup

describe("Database Connection Tests", () => {
    it("should connect to the database successfully", async () => {
        try {
            const pool = await sql.connect(config);
            expect(pool.connected).toBeTruthy();
        } catch (err) {
            throw new Error("Connection failed: " + err.message);
        }
    });
});

替代解决方案：错误处理和重试逻辑

Node.js - 弹性数据库连接的重试机制

const sql = require('mssql');
const config = require('./config');

// Retry wrapper function to handle transient network issues in Docker
async function connectWithRetry(retries = 5) {
    for (let i = 0; i < retries; i++) {
        try {
            await sql.connect(config);
            console.log("Connected to database.");
            return;
        } catch (err) {
            if (i === retries - 1) throw err;
            console.warn("Retrying connection...");
            await new Promise(res => setTimeout(res, 2000)); // Wait before retry
        }
    }
}

connectWithRetry();

有关 Docker 化 SQL Server 连接问题的常见问题

1. 是什么导致 Docker 化应用程序中出现 getaddrinfo ENOTFOUND 错误？
2. 此错误通常源于 Docker 内的 DNS 解析问题，其中应用程序无法解析 SQL Server 的主机名。 Docker 的隔离网络设置通常需要配置才能实现可靠的主机名访问。
3. 如何在 Docker 中通过主机名访问我的 SQL Server？
4. 使用 Docker Compose 使用命名服务，例如将 SQL Server 定义为“db”，然后通过该别名访问它。 Docker 会自动将其添加到其内部 DNS，这有助于解析 Docker 网络内的主机名。
5. 为什么我的应用程序可以在本地运行，但不能在 Docker 中运行？
6. 在本地，您的应用程序使用系统 DNS 来解析主机名，而在 Docker 中，它使用容器化网络。如果没有正确的配置，Docker 可能无法找到 SQL Server，从而导致错误。
7. dependent_on 命令在 Docker Compose 中起什么作用？
8. 这 depends_on 命令有助于控制服务的启动顺序。例如，确保 SQL Server 在应用程序之前启动可以防止初始化期间出现连接错误。
9. 我应该在 Docker 中对数据库连接使用重试吗？
10. 是的！实现延迟较小的重试机制可以非常有效地处理数据库容器需要额外时间才能完全访问的情况。
11. 我可以从 Docker 容器访问外部 SQL Server 吗？
12. 是的，但是 Docker 网络可能需要额外的配置。使用桥接网络或添加静态 IP 可以帮助 Docker 化应用程序访问非 Docker SQL Server。
13. 有没有办法测试我的 Dockerized 应用程序与 SQL Server 的连接？
14. 绝对地。您可以使用类似的库编写单元测试 Jest 在 Node.js 中验证应用程序是否在本地和 Docker 内正确连接。
15. 为什么 Docker 的网络配置对于 SQL Server 应用程序很重要？
16. Docker 网络隔离可以防止服务相互发现，从而影响 SQL Server 连接。配置网络选项有助于确保应用程序可以一致地访问数据库。
17. 我可以使用环境变量来管理 Docker 中的数据库设置吗？
18. 是的，建议使用环境变量来安全地存储敏感信息，并且它们可以轻松调整不同环境的配置。
19. 桥接网络在 Docker SQL Server 连接中的作用是什么？
20. 桥接网络允许容器在同一主机内进行通信，这对于需要访问 SQL Server 等外部服务而无需复杂网络的 Docker 应用程序非常有用。
21. 如何处理 Docker DNS 缓存问题？
22. 为了避免缓存问题，请确保 DNS 适当刷新。在某些情况下，重新启动 Docker 守护进程或为 Docker 的 DNS 缓存配置 TTL（生存时间）会有所帮助。

结束您的故障排除之旅

寻址 网络问题 在 Docker 中似乎令人不知所措，尤其是在 SQL Server 中。通过设置网络别名并依靠 Docker Compose 控制启动顺序，您可以帮助您的应用程序与数据库顺利通信。每一项调整都将使您的 Docker 化环境更具弹性。

此外，即使服务在不同时间启动，合并重试和强大的错误处理也使应用程序可靠。通过这些最佳实践，您可以在容器化设置中维护本地开发的可靠性，减少 ENOTFOUND 等错误，并确保 Docker 应用程序的无缝数据库连接。 🚀