c-ares DNS misconfiguration on Windows Consumption causes mongodb+srv:// and dns.resolve*() failures

Open
#830 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
64/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
azure, node.js, typescript

Research direction

Start in nodejsWorker.ts and trace the worker startup path before user code and gRPC setup. Review the proposed dns.getServers() and dns.setServers() guard, checking the Windows Consumption condition and the empty or 127.0.0.1 cases. Done means affected SRV lookups use Azure DNS without changing dedicated, Premium, ASE, Linux, or dns.lookup() behavior.

Written by the indexing model from the issue text.

Description

Problem

On Windows Consumption plan (Dynamic SKU), the Node.js dns.resolve*() family of functions (which use the c-ares library internally) can fail with ECONNREFUSED 127.0.0.1:53 or ETIMEOUT errors. This affects any application that relies on SRV record lookups, most notably mongodb+srv:// connection strings used with MongoDB Atlas and Cosmos DB MongoDB API.

Root Cause

Node.js has two completely separate DNS resolution paths:

Path Mechanism Sandbox-aware?
dns.lookup() OS getaddrinfo() Yes — the Consumption sandbox detours getaddrinfo() to Azure DNS (168.63.129.16)
dns.resolve*() / dns.resolveSrv() c-ares library (raw UDP) No — c-ares reads DNS servers directly from the Windows registry

A known c-ares bug causes a character-width mismatch (sizeof(TCHAR) vs sizeof(WCHAR)) when reading the Windows registry DhcpNameServer / NameServer entries. On Consumption plan VMs — where the DHCP DNS suffix list is empty — this causes c-ares to:

  1. Misread the empty DHCP suffix string due to the character-width bug
  2. Discard the valid Azure DNS server address (168.63.129.16)
  3. Fall back to 127.0.0.1:53 (localhost, where no DNS server is listening)

As a result, any dns.resolveSrv() call (e.g., MongoDB SRV connection discovery) fails immediately with ECONNREFUSED or times out.

Why most apps are unaffected

Most Node.js applications never trigger the c-ares code path. HTTP clients, regular database drivers, and net.connect() all use dns.lookup() (getaddrinfo), which is correctly sandboxed. Only applications that explicitly use:

  • mongodb+srv:// connection strings (triggers dns.resolveSrv())
  • dns.resolve(), dns.resolve4(), dns.resolveSrv(), etc. directly
  • Libraries that create dns.Resolver instances

...are affected. Kusto telemetry across the entire East US fleet shows only ~8 apps with querySrv errors in a 24-hour window, confirming the narrow blast radius.

Mitigation
const dns = require('dns');dns.setServers(['168.63.129.16']);
Upstream fix status
  • c-ares fix: c-ares/c-ares#1064 — merged
  • Node.js backport: nodejs/node#61453 — merged, backported to v20.20.1, v24.14.0, v25.6.1
  • Current platform versions: Node 20.20.2, 22.22.3, 24.16.0 — all include the fix
  • Fix completeness: nodejs/node#62326 reports the fix may be incomplete — users still observe ECONNREFUSED and dns.getServers() returning 127.0.0.1 on patched versions (v24.14.0, v25.8.1)

Because the upstream fix is potentially incomplete, upgrading Node.js versions alone does not reliably resolve the issue.

Proposed Solution

Add a DNS server guard to the worker entry point (nodejsWorker.ts) that detects and corrects the c-ares misconfiguration before any user code or gRPC connections are established.

Implementation sketch
// Fix c-ares DNS server misconfiguration on Windows Consumption sandbox.
// See: https://github.com/c-ares/c-ares/issues/1056
//      https://github.com/nodejs/node/issues/62326
if (process.platform === 'win32' && process.env.WEBSITE_SKU === 'Dynamic') {
    try {
        const dns = require('dns');
        const servers = dns.getServers();
        if (servers.length === 0 || (servers.length === 1 && servers[0] === '127.0.0.1')) {
            dns.setServers(['168.63.129.16']);
        }
    } catch (_) {
        // Best-effort: do not crash if DNS module fails
    }
}
Why this approach
Aspect Detail
Scope Only activates on Windows Consumption (WEBSITE_SKU === "Dynamic"). Dedicated, Premium, ASE, and Linux are unaffected
Safety Checks dns.getServers() first; only overrides if the current value is broken (empty or 127.0.0.1)
Timing Executes before gRPC setup, before user code, before library imports — the earliest possible point
Code size ~10 lines
Side effects None. dns.setServers() only affects the global c-ares channel; dns.lookup() behavior is unchanged
Alternatives considered
Alternative Why not
Wait for upstream c-ares fix Fix is incomplete per nodejs/node#62326; timeline unknown
Patch the sandbox to intercept c-ares UDP Requires changes to the site container; complex with large blast radius
Monkey-patch dns.resolveSrv() Fragile, version-dependent, maintenance burden
Customer-side dns.setServers() workaround Requires every affected customer to discover and apply the fix; not scalable

Impact

  • Current: Multiple CRIs filed, affecting customers using mongodb+srv:// on Windows Consumption
  • Fleet-wide: ~8 apps affected in East US alone in any 24-hour window (Kusto: FunctionsLogs | where Summary has "querySrv")
  • Customer experience: Complete inability to connect to MongoDB Atlas / Cosmos DB MongoDB API when using SRV connection strings

Related Issues

Dominant language
TypeScript
Stars
110
Forks
51
Avg merge
8d 8h
Merged PRs (30d)
3

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Azure/azure-functions-nodejs-worker

All issues in Azure/azure-functions-nodejs-worker

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.