ASP.NET Core配合PostgreSQL部署Linux时报OutOfMemory异常如何解决？

常见原因 #

• 种子数据体量过大，一次性全量加载到内存写入，未做分批处理，叠加Linux服务器内存配额不足触发OOM
• PostgreSQL连接配置错误或访问权限未开放，Npgsql底层连接重试机制反复申请内存，最终耗尽资源抛出异常
• EF Core模型存在循环引用配置，种子数据插入阶段变更追踪器加载大量冗余实体，内存占用持续飙升
• 服务器硬件配置过低（1G及以下内存），PostgreSQL运行本身已占用大半内存，应用初始化时无剩余内存可分配
• Npgsql.EntityFrameworkCore.PostgreSQL 版本与ASP.NET Core版本、PostgreSQL服务版本不兼容，驱动存在内存泄漏bug

修复方案 #

1. 优化种子数据写入逻辑 #

大批量种子数据不要一次性调用AddRange插入，改用分批写入，每批插入后手动清理变更追踪器缓存释放内存，参考代码：

// 按200条为一批拆分插入
foreach (var batch in seedDataList.Chunk(200))
{
    context.AddRange(batch);
    await context.SaveChangesAsync();
    context.ChangeTracker.Clear();
}

如果种子数据从本地文件读取，不要一次性加载整个文件到内存，改用流式读取逐行处理。

2. 校验数据库连接配置与权限 #

首先在Linux服务器本地用psql命令测试数据库连接是否正常，确认连接字符串参数完全匹配：

psql -h 127.0.0.1 -p 5432 -U 你的数据库账号 -d 你的数据库名

检查PostgreSQL配置文件：

• pg_hba.conf：确认允许应用所在IP访问数据库
• postgresql.conf：确认监听地址配置为*或应用所在IP
  连接字符串增加超时配置，避免无限重试：
  Host=127.0.0.1;Port=5432;Database=xxx;Username=xxx;Password=xxx;Timeout=15;Command Timeout=30

3. 优化EF Core模型配置 #

检查实体是否存在不必要的循环导航属性引用，种子数据插入阶段临时关闭自动变更检测：

context.ChangeTracker.AutoDetectChangesEnabled = false;

如果存在大字段（text、bytea等类型），单独处理对应字段的写入，避免和其他数据同时加载。

4. 调整服务器内存配置 #

执行free -h查看服务器剩余内存，若剩余内存不足1G，可临时创建交换分区缓解内存压力：

# 创建2G交换分区示例
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

长期方案可升级服务器内存，或调低PostgreSQL内存占用参数：修改postgresql.conf中shared_buffers为64MB（低配置机器适配值）。

5. 校验版本兼容性 #

确保Npgsql.EntityFrameworkCore.PostgreSQL的大版本和ASP.NET Core大版本完全一致，比如.NET 6对应6.x版本的Npgsql包，.NET 7对应7.x版本的Npgsql包，同时确认PostgreSQL服务版本在Npgsql的支持范围内。

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