EF Core如何使用空间数据类型 EF Core NetTopologySuite地理信息教程

EF Core 使用空间数据需三步：安装对应数据库的 NetTopologySuite 扩展包并引用 NetTopologySuite 基础包；在 DbContext 配置中调用 UseNetTopologySuite()；实体属性使用 NTS 几何类型并显式设置 SRID 4326，注意坐标顺序为经度优先。

EF Core 使用空间数据，核心是靠 NetTopologySuite（NTS） 提供几何类型支持，并配合数据库提供者的空间扩展包完成映射与查询。它不是开箱即用的功能，需要显式启用、正确配置类型和 SRID，否则会报错或行为异常。

安装对应数据库的 NetTopologySuite 扩展包

不同数据库需引用不同的空间扩展包，不能混用：

• SQL Server：`Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite`
• PostgreSQL（PostGIS）：`Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite`
• SQLite（SpatiaLite）：`Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite` + `sqlite3` 原生库（macOS/Linux 需设 DYLD_LIBRARY_PATH）
• MySQL（Pomelo）：`Pomelo.EntityFrameworkCore.MySql.NetTopologySuite`

同时必须安装基础 NTS 包：NetTopologySuite，它是所有几何类型（Point、Polygon、LineString 等）的来源。

在 DbContext 中启用 NetTopologySuite

配置连接时，必须显式调用 UseNetTopologySuite() 方法：

// SQL Server 示例
options.UseSqlServer(connectionString, x => x.UseNetTopologySuite());
// PostgreSQL 示例
options.UseNpgsql(connectionString, x => x.UseNetTopologySuite());
// SQLite 示例
options.UseSqlite(connectionString, x => x.UseNetTopologySuite());

登录后复制

注意：不加这一步，即使模型里用了 Point，EF Core 也会忽略空间能力，生成普通 BLOB 或字符串字段，查询也完全无法使用空间函数。

定义实体中的空间属性并指定 SRID

NTS 类型默认 SRID 为 0，但绝大多数地理场景（如 GPS、地图 API）要求明确使用 SRID 4326（WGS 84）：

标签： mysql linux 前端 go mac ai macos microsoft sqlserver cos .net