docs: add troubleshooting note for querySrv ECONNREFUSED on Windows#16342
Merged
vkarpov15 merged 2 commits intoJun 28, 2026
Merged
Conversation
vkarpov15
reviewed
Jun 26, 2026
vkarpov15
left a comment
Collaborator
There was a problem hiding this comment.
I believe this change belongs in the FAQ section faq.md not at the top of the connections docs. Do you think that is reasonable @Ajay-Naik ?
Contributor
Author
|
That makes sense, @vkarpov15. I'll move it to faq.md. Give me a moment to
update the PR.
…On Sat, 27 Jun 2026 at 01:18, Valeri Karpov ***@***.***> wrote:
***@***.**** commented on this pull request.
I believe this change belongs in the FAQ section faq.md not at the top of
the connections docs. Do you think that is reasonable @Ajay-Naik
<https://github.com/Ajay-Naik> ?
—
Reply to this email directly, view it on GitHub
<#16342?email_source=notifications&email_token=BBFOR7PIF2B3JXWS4WVRCKT5B3HPLA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINJYGIZTANRTGUZ2M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#pullrequestreview-4582306353>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/BBFOR7NYE2BDYGOHHB45UTL5B3HPLAVCNFSNUABCKJSXA33TNF2G64TZHM2TSNZYG44TWSLTON2WKOZUG42DIOJXGYZTINFBOYBA>
.
Triage notifications, keep track of coding agent tasks and review pull
requests on the go with GitHub Mobile for iOS
<https://github.com/notifications/mobile/ios/BBFOR7JKNS4KZHW2UBX5M2T5B3HPLA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINJYGIZTANRTGUZ2M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJKTGN5XXIZLSL5UW64Y>
and Android
<https://github.com/notifications/mobile/android/BBFOR7ITXJCC6HJFDD3UAWD5B3HPLA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINJYGIZTANRTGUZ2M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLTGN5XXIZLSL5QW4ZDSN5UWI>.
Download it today!
You are receiving this because you were mentioned.Message ID:
***@***.***>
|
Contributor
Author
|
Done, @vkarpov15. Moved it to faq.md. Let me know if you'd like any
further changes.
…On Sat, 27 Jun 2026 at 09:28, AJAY NAIK ***@***.***> wrote:
That makes sense, @vkarpov15. I'll move it to faq.md. Give me a moment
to update the PR.
On Sat, 27 Jun 2026 at 01:18, Valeri Karpov ***@***.***>
wrote:
> ***@***.**** commented on this pull request.
>
> I believe this change belongs in the FAQ section faq.md not at the top
> of the connections docs. Do you think that is reasonable @Ajay-Naik
> <https://github.com/Ajay-Naik> ?
>
> —
> Reply to this email directly, view it on GitHub
> <#16342?email_source=notifications&email_token=BBFOR7PIF2B3JXWS4WVRCKT5B3HPLA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINJYGIZTANRTGUZ2M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#pullrequestreview-4582306353>,
> or unsubscribe
> <https://github.com/notifications/unsubscribe-auth/BBFOR7NYE2BDYGOHHB45UTL5B3HPLAVCNFSNUABCKJSXA33TNF2G64TZHM2TSNZYG44TWSLTON2WKOZUG42DIOJXGYZTINFBOYBA>
> .
> Triage notifications, keep track of coding agent tasks and review pull
> requests on the go with GitHub Mobile for iOS
> <https://github.com/notifications/mobile/ios/BBFOR7JKNS4KZHW2UBX5M2T5B3HPLA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINJYGIZTANRTGUZ2M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJKTGN5XXIZLSL5UW64Y>
> and Android
> <https://github.com/notifications/mobile/android/BBFOR7ITXJCC6HJFDD3UAWD5B3HPLA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINJYGIZTANRTGUZ2M4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJLTGN5XXIZLSL5QW4ZDSN5UWI>.
> Download it today!
> You are receiving this because you were mentioned.Message ID:
> ***@***.***>
>
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
Adds a troubleshooting note to
docs/connections.mdfor thequerySrv ECONNREFUSEDerror when connecting to MongoDB Atlasusing
mongodb+srv://on Windows.Why
This error affects many developers but is not currently documented
in Mongoose's connection docs. The fix (
dns.setServers()) isscattered across Medium articles and Stack Overflow but has no
official reference.
Root cause: Node.js uses its own DNS resolver (c-ares) which can
fail to resolve SRV records on Windows even when OS DNS works fine.
This was confirmed as a Node.js regression in v24.13.0:
nodejs/node#61453
Fix
Force Node.js to use Google's public DNS at the application level:
const dns = require('dns');
dns.setServers(['8.8.8.8', '8.8.4.4']);
References