如何在新Blazor Server Web App中连接现有PostgreSQL数据库并解决脚手架报错

核心疑问解答 #

不需要预先在appsettings.json配置连接字符串，也不需要先将DbContext添加到服务容器。Scaffold-DbContext命令的作用就是直接从数据库生成DbContext和实体类，配置连接字符串、注册服务是生成代码之后的后续操作。

当前异常原因分析 #

你遇到的System.Net.Sockets.SocketException (0x00002AF9) No such host known错误，本质是无法解析或访问指定的数据库主机地址，和是否提前配置appsettings无关，重点排查以下几点：

• 核对连接字符串中host=xx.xx.xx.xxx的IP地址是否正确，确认数据库服务器的网络可达性（比如远程服务器是否开启公网访问）
• 验证port=xxxx端口是否开放，可通过telnet xx.xx.xx.xxx xxxx或端口检测工具测试连通性
• 确保<STORAGE_DIR>已替换为实际的证书存储路径（比如Windows下的C:\Users\你的用户名，Linux/macOS下的~），路径错误可能间接影响连接流程
• 检查本地网络是否存在防火墙、代理等拦截规则，阻止了对数据库服务器的访问

正确操作流程 #

1. 确认已安装所需NuGet包（你已完成此步骤）：

   Microsoft.EntityFrameworkCore
   Microsoft.EntityFrameworkCore.Tools
   Npgsql.EntityFrameworkCore.PostgreSQL
   

2. 修正连接字符串中的主机、端口、证书路径等信息，确保能正常连接数据库
3. 在包管理器控制台执行修正后的脚手架命令：

   Scaffold-DbContext "host=正确的IP地址 port=正确端口 dbname=postgres user=用户名 password=密码 sslmode=prefer connect_timeout=10 sslcert=实际证书路径/postgresql.crt sslkey=实际证书路径/postgresql.key" Npgsql.EntityFrameworkCore.PostgreSQL -OutputDir Models
   

4. 生成代码后，再完成后续配置：
   • 在appsettings.json中添加连接字符串：

     "ConnectionStrings": {
       "PostgresConn": "你的完整连接字符串"
     }
     

   • 在Program.cs中注册DbContext到服务容器：

     builder.Services.AddDbContext<YourGeneratedDbContext>(options =>
         options.UseNpgsql(builder.Configuration.GetConnectionString("PostgresConn")));
     

内容的提问来源于stack exchange，提问作者Nicolai Nygaard