为何该PostgreSQL查询在pgAdmin和CLI可用，Node.js中却报错？

你的SQL查询在CLI环境能正常运行，但在Node.js中执行时却报错syntax error at or near "SELECT"，核心问题出在内层嵌套子查询的冗余写法上。PostgreSQL的CLI对这类冗余语法兼容性较强，但Node.js常用的SQL客户端（比如pg模块）的语法解析规则更严格，会判定该写法为语法错误。

原查询的问题点 #

原查询中用额外括号包裹单值子查询的写法属于冗余格式，是触发报错的关键：

-- 冗余的嵌套写法示例
SELECT (select ST_transform(ST_SetSRID(ST_MakePoint(...),4326),3857)) AS RES_LOC,   
       (SELECT ST_Transform((select u.poly FROM USERS u WHERE ...), 3857)) AS USER_POLY

优化后的查询写法 #

直接去掉单值子查询的外层括号，或者扁平化查询结构，即可让Node.js客户端正确解析执行：

写法一：简化内层子查询

SELECT ST_Distance(USER_POLY, RES_LOC) AS dist 
FROM (
  SELECT 
    ST_Transform(ST_SetSRID(ST_MakePoint(11.61594943945313, 48.12707189053979), 4326), 3857) AS RES_LOC,   
    ST_Transform((SELECT u.poly FROM USERS u WHERE u.user_id = '83b71cee-e9b8-46cb-9bee-6d7ee6f44cc6'), 3857) AS USER_POLY
) AS foo

写法二：完全扁平化查询（性能更优）

直接通过主查询关联用户表，彻底避免多层嵌套：

SELECT 
  ST_Distance(
    ST_Transform(u.poly, 3857), 
    ST_Transform(ST_SetSRID(ST_MakePoint(11.61594943945313, 48.12707189053979), 4326), 3857)
  ) AS dist
FROM USERS u
WHERE u.user_id = '83b71cee-e9b8-46cb-9bee-6d7ee6f44cc6'

说明 #

两种写法都能在Node.js环境正常执行，其中写法二减少了子查询嵌套层级，不仅更符合SQL标准写法，查询性能也更优。

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