跳到主要内容

Postgres 节点常见问题#

以下是 Postgres 节点 的常见错误与问题及其解决或排查步骤。

使用参数动态填充 SQL IN 条件组#​

在 Postgres 中，您可以使用 SQL IN 比较结构 进行多值组的比较：

SELECT color, shirt_size FROM shirts WHERE shirt_size IN ('small', 'medium', 'large');

虽然您可以在查询中使用n8n表达式动态填充IN分组中的值，但将其与查询参数结合使用时，能通过自动清理输入内容提供额外保护。

构建带查询参数的IN分组查询时：

  1. 将操作类型设为执行查询
  2. 在选项中勾选查询参数
  3. 使用表达式从输入数据中选择数组，例如：{{ $json.input_shirt_sizes }}
  4. 在查询参数中编写包含空括号IN结构的查询语句，例如：

SELECT color, shirt_size FROM shirts WHERE shirt_size IN ();

  1. 在 IN 括号内部，使用表达式为查询参数数组中的项目数量动态创建基于索引的占位符（例如 $1、$2 和 $3）。由于占位符变量采用 1 起始索引，您可以通过将每个数组索引加一来实现：

SELECT color, shirt_size FROM shirts WHERE shirt_size IN ({{ $json.input_shirt_sizes.map((i, pos) => "$" + (pos+1)).join(', ') }});

采用该技术后，n8n会根据数组中元素的数量，自动为IN值创建正确数量的预处理语句占位符。

时间戳与时区处理#​

为避免n8n与Postgres在解析时间戳和时区数据时产生歧义，请遵循以下通用建议：

  • 存储和传递日期时使用UTC时区：在不同系统和表示形式间转换日期时，采用UTC时区有助于避免时区转换混乱。
  • 设置执行时区：可通过环境变量（自托管版本）或设置界面（n8n云平台）配置n8n全局时区。还可在工作流设置中设定特定工作流的时区。
  • 采用ISO 8601格式：ISO 8601格式将日期各组成部分编码为标准化的字符串。n8n在节点间以字符串形式传递日期，并使用Luxon进行解析。如需显式转换为ISO 8601格式，可通过日期时间节点设置自定义格式为yyyy-MM-dd'T'HH:mm:ss。

将日期列输出为日期字符串而非ISO时间戳字符串#​

n8n通过pg包与Postgres集成，这影响了n8n处理Postgres日期、时间戳及相关类型的方式。

默认情况下，pg包会将DATE值解析为new Date(row_value)，生成符合ISO 8601时间戳字符串格式的日期。例如，根据实例时区设置，日期2025-12-25可能生成时间戳字符串2025-12-25T23:00:00.000Z。

如需调整此行为，可在查询时使用Postgres的TO_CHAR函数将日期格式化为目标格式：

SELECT TO_CHAR(date_col, 'YYYY-MM-DD') AS date_col_as_date FROM table_with_date_col

这将生成仅包含日期部分的字符串，不包含时间或时区组件。延续之前的示例，通过这种类型转换，日期2025-12-25将生成字符串2025-12-25。更多详细信息可查阅pg包中关于日期的文档。