如何在Golang sqlc中获取可选输出？解决next_timestamp查询类型问题

方法1：生成*time.Time返回类型 #

保持初始查询不变：

-- name: GetNextTimestamp :one
SELECT MIN(next_timestamp) FROM tableA
WHERE next_timestamp > CURRENT_TIMESTAMP;

修改sqlc.yaml配置，将可空的时间类型映射为Go指针类型：

version: "2"
sql:
  - schema: "你的schema文件路径"
    queries: "你的queries文件路径"
    engine: "postgresql" # 根据你的数据库调整，如MySQL填"mysql"
    gen:
      go:
        out: "db"
        sql_package: "database/sql"
        overrides:
          - db_type: "timestamptz" # MySQL对应"datetime"或"timestamp"
            go_type:
              import: "time"
              type: "*Time"

这样生成的GetNextTimestamp函数会返回*time.Time，无符合条件行时返回nil，不会触发扫描错误。

方法2：使用sql.NullTime处理空值 #

调整查询给结果列加别名：

-- name: GetNextTimestamp :one
SELECT MIN(next_timestamp) AS next_timestamp FROM tableA
WHERE next_timestamp > CURRENT_TIMESTAMP;

在sqlc.yaml中配置映射为sql.NullTime：

version: "2"
sql:
  - schema: "你的schema文件路径"
    queries: "你的queries文件路径"
    engine: "postgresql"
    gen:
      go:
        out: "db"
        sql_package: "database/sql"
        overrides:
          - db_type: "timestamptz"
            go_type:
              import: "database/sql"
              type: "NullTime"

生成的函数返回sql.NullTime，可通过Valid字段判断是否有有效时间，Time字段获取具体值。

方法3：强制查询返回可空类型（无需全局配置） #

用CAST明确指定可空时间类型，让sqlc自动识别：

-- name: GetNextTimestamp :one
SELECT CAST(MIN(next_timestamp) AS timestamptz) FROM tableA
WHERE next_timestamp > CURRENT_TIMESTAMP;

无符合条件行时CAST保留NULL，sqlc会生成*time.Time类型返回值。

问题根源 #

• 初始查询中sqlc无法确定MIN(next_timestamp)的可空性，默认生成interface{}。
• 你修改后的查询强制转类型，但sqlc可能生成了非指针time.Time，无法容纳NULL值，导致扫描报错。
• 可空类型（*time.Time/sql.NullTime）能正确处理NULL结果，避免扫描错误。

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