为何视图计算字段出现Scan error on column index 5...无法转null为int？

核心原因 #

你遇到的问题大概率是视图的计算字段在特定场景下会返回NULL，只是你平时查询没覆盖到这些场景；或者你对“数据无NULL”的判断有误——比如只查了常规数据，没考虑边缘情况（比如无匹配关联行、聚合函数无统计结果等）。

具体来说，计算字段容易产生NULL的场景包括：

• 聚合函数（如SUM()、COUNT()）在没有匹配行时会返回NULL，而非0；
• 关联查询中，左/右连接的不匹配行对应的计算字段会为NULL；
• 自定义函数、CASE表达式未覆盖所有分支，导致返回NULL；
• 数学运算（如除法）遇到非法值时返回NULL。

另外，即使你看到的视图查询结果里没有NULL，也可能是因为你查询的数据集刚好没触发这些场景，但代码执行的query可能包含不同的过滤条件，导致某次查询命中了NULL值。

解决办法 #

1. 修复视图计算逻辑，避免NULL产生
   在视图的计算字段里用COALESCE函数兜底，把NULL转为合法的int默认值，比如：

   -- 原计算字段：SUM(amount)
   -- 修改后：
   COALESCE(SUM(amount), 0) AS total_amount
   

   这样无论什么情况，该字段都会返回非NULL的int值。

2. 修改Go结构体字段类型为可空类型
   如果业务允许该字段为NULL，把结构体中对应列的类型从int改为sql.NullInt64或*int：

   type chkRecord struct {
       // 原字段：TotalAmount int `db:"total_amount"`
       TotalAmount sql.NullInt64 `db:"total_amount"`
       // 或者用指针：TotalAmount *int `db:"total_amount"`
   }
   

   这样sqlx就能正确扫描NULL值。

3. 验证查询语句的实际返回值
   把代码中执行的query直接拿到数据库客户端执行，加上代码中实际使用的参数，检查返回结果的第6列（索引从0开始，index5对应第6列）是否存在NULL值，确认触发场景。

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