Skip to content

错误：连接 Supabase 项目时出现 "NXDOMAIN"

Last edited: 10/14/2026

NXDOMAIN 错误意味着你要连接的主机名的 DNS 解析失败。主机名不存在，或者在你所连接的网络上无法解析。请按顺序检查以下可能原因。

🌐 An NXDOMAIN error means DNS resolution failed for the hostname you're connecting to. The hostname doesn't exist, or it can't resolve on the network you're connecting from. Work through the following causes in order.

主机名里的项目引用错了 #

🌐 Wrong project reference in the hostname

项目引用中哪怕一个字符不匹配也会生成 NXDOMAIN。在仪表板中打开项目时，可以从地址栏获取项目引用，或者从 项目设置 获取，然后复制而不是重新输入。

🌐 A single mismatched character in the project reference produces NXDOMAIN. Get the project reference from the address bar while your project is open in the dashboard, or from Project Settings, and copy it rather than retyping it.

确认主机名以 .supabase.co 结尾。项目主机名从不以 .supabase.com 结尾；那个域名是用来做营销网站和仪表盘的，不用于项目连接。

🌐 Confirm the hostname ends in .supabase.co. Project hostnames never end in .supabase.com; that domain serves the marketing site and dashboard, not project connections.

项目暂停了 #

🌐 Project is paused

已暂停的项目会停止提供其主机名，因此即使项目仍然存在，对它的连接也会解析为 NXDOMAIN。请查看你的项目列表是否显示为已暂停状态，如果是的话，可以恢复项目。

🌐 A paused project stops serving its hostname, so connections to it resolve as NXDOMAIN even though the project still exists. Check your project list for a Paused status, and resume the project if it's paused.

项目已被删除 #

🌐 Project was deleted

已删除项目的主机名将永久无法解析。如果你使用的是团队计划或更高级别的计划，可以查看你们组织的审计日志来确认项目是否被删除。

🌐 A deleted project's hostname stops resolving permanently. If you're on a Team plan or above, check your organization's audit logs to confirm whether the project was deleted.

DNS解析只在某些网络上失败 #

🌐 DNS resolution fails only certain networks

如果 supabase.co 和多个无关的 *.supabase.co 主机名在某些网络上都无法解析，但在 VPN 或其他网络上可以解析，那么问题可能出在该网络的 DNS 解析器，而不是 Supabase。这在限制较多的移动运营商、办公网络或 ISP 网络上很常见。

🌐 If supabase.co and multiple unrelated *.supabase.co hostnames all fail to resolve on certain networks, but resolve over a VPN or a different network, the problem could be with that network's DNS resolver rather than with Supabase. This is common on restrictive mobile carrier, office, or ISP networks.

  • 将你的设备或路由切换到公共 DNS 解析器，例如 Cloudflare（1.1.1.1）或 Google（8.8.8.8）。
  • 清空本地 DNS 缓存，然后重启浏览器或设备。
  • 检查是否有任何可能阻止访问的杀毒软件、网络或防火墙系统。
  • 在不同的网络或通过 VPN 测试，确认那里的主机名能解析。
  • 如果只有你们内部公司的网络受到影响，那就找你们的网络管理员，因为他们的解析器可能解析不了 supabase.co。
  • 这篇博客文章有更多关于绕过地区网络封锁的信息。

如果你能通过上面的任何步骤解决问题，请提交一个支持工单，让我们的团队评估情况。

🌐 If you are able to work around the issue using any steps above, please open a support ticket so our team can assess the situation.

自定义域名主机名无法解析 #

🌐 Custom domain hostname fails to resolve

自定义域名的 DNS 记录由你自己的域名注册商或 DNS 提供商管理，而不是 Supabase。将其视为平台问题前，先向你的提供商检查一下 DNS 配置。

🌐 A custom domain's DNS records are managed by your own domain registrar or DNS provider, not Supabase. Check the DNS configuration with your provider before treating it as a platform issue.

如果问题继续 #

🌐 If the problem continues

如果以上原因都不适用，请为你的项目提交支持工单，并提供确切的主机名、错误信息以及你已经测试过的网络。

🌐 Open a support ticket for your project if none of these causes apply, and include the exact hostname, the error message, and the networks you've already tested from.