如何解决Laravel执行PostgreSQL查询时的临时文件空间不足错误？

兄弟，这个问题我之前处理过好几次——本质就是你的大查询触发了PostgreSQL的临时文件生成，但存储这些临时文件的磁盘分区空间不够用了。下面给你一步步来解决：

1. 先搞清楚临时文件存在哪、哪个盘满了 #

先登录服务器，打开PostgreSQL命令行，跑这条命令看临时文件的存储位置：

SHOW temp_tablespaces;

如果返回是空或者pg_default，说明临时文件就存在数据库默认的数据目录所在的磁盘。

然后用系统命令看所有磁盘的空间使用情况：

df -h

找到那个显示100%或者接近满的分区，确认是不是刚才查到的临时文件所在分区。

2. 紧急清理：先把满的空间腾出来 #

如果是临时文件占满了空间，先紧急清理一波（注意：最好先停掉正在跑的大查询，不然可能中途报错）：

• 先找到临时文件的具体目录，一般是/var/lib/postgresql/<你的PostgreSQL版本>/main/pg_temp_*，或者你刚才查到的自定义目录
• 先停PostgreSQL服务（可选，但更安全）：

sudo systemctl stop postgresql

• 删除临时文件目录下的所有文件：

sudo rm -rf /var/lib/postgresql/<版本号>/main/pg_temp_*

• 重启PostgreSQL：

sudo systemctl start postgresql

3. 从根源解决：优化你的查询语句 #

大数据量的查询如果写得糙，很容易生成巨量临时文件，比如排序、分组这些操作。给你几个优化方向：

• 给ORDER BY、GROUP BY、DISTINCT用到的字段加索引，这样PostgreSQL可以直接用索引排序，不用生成临时文件：

CREATE INDEX idx_你的表名_字段名 ON 你的表名(要排序/分组的字段);

• 如果不需要全量数据，一定要加LIMIT限制返回行数，Laravel里这么写：

YourModel::query()->orderBy('你的字段')->limit(1000)->get();

• 别用SELECT *，只查你需要的字段，减少数据处理量：

YourModel::query()->select('id', 'name', 'created_at')->get();

• 如果是关联查询，尽量用join代替嵌套子查询，优化关联条件，减少不必要的数据扫描。

4. 长期方案：把临时文件移到更大的磁盘 #

如果经常要跑大查询，最好把临时文件的存储目录转移到空间更大的磁盘：

1. 在大磁盘上创建一个专门的临时目录，比如/mnt/big_disk/pg_temp，然后修改权限让PostgreSQL能访问：

sudo mkdir /mnt/big_disk/pg_temp
sudo chown postgres:postgres /mnt/big_disk/pg_temp
sudo chmod 700 /mnt/big_disk/pg_temp

2. 登录PostgreSQL，创建一个新的临时表空间：

CREATE TABLESPACE temp_space LOCATION '/mnt/big_disk/pg_temp';

3. 设置默认的临时表空间为这个新的：

ALTER SYSTEM SET temp_tablespaces = 'temp_space';

4. 重启PostgreSQL让配置生效：

sudo systemctl restart postgresql

5. 调整PostgreSQL参数，减少临时文件生成 #

还可以调整PostgreSQL的内存参数，让它尽量用内存处理，少生成临时文件：

• 修改work_mem：这个参数控制每个查询操作（比如排序、哈希关联）能用到的内存，内存够的话就不会写临时文件。打开postgresql.conf文件，找到这个参数修改：

work_mem = 64MB  # 服务器内存大的话可以设到128MB甚至256MB，注意别设太大，不然多个连接同时跑会耗光内存

• 还有maintenance_work_mem，这个是给创建索引、vacuum这些维护操作用的，也可以调大一点：

maintenance_work_mem = 256MB

改完之后记得重启PostgreSQL生效。

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