MySQL递归查询本地MariaDB10.5运行正常，部署到Heroku报错如何解决

1. 确认Heroku端数据库类型与版本兼容性 #

你本地使用的MariaDB 10.5原生支持递归CTE语法，但Heroku的默认MySQL服务（如ClearDB、JawsDB）很多默认版本低于8.0，不支持递归CTE语法，会直接导致查询报错或者结果异常。可选择两种解决方案：

• 更换Heroku数据库服务，选择支持MariaDB 10.5+或MySQL 8.0+的服务版本
• 改写递归CTE为非递归的日期生成逻辑，兼容低版本数据库：

select curdate() - interval num day as dte
from (
    select 0 as num union all select 1 union all select 2 union all
    select 3 union all select 4 union all select 5 union all select 6
) as nums

2. 排查时区差异问题 #

时区差异是该场景下最高发的问题，Heroku数据库默认时区为UTC，和你本地的时区不一致会导致curdate()返回的日期和实际业务日期差了几个小时，直接导致日期范围关联结果完全不符合预期。解决方案：

• 执行查询前先设置会话时区和业务时区一致，例如国内业务可执行SET time_zone = 'Asia/Shanghai';
• 或者将所有业务时间统一按UTC格式存储，查询时统一用UTC时间做计算

3. 校验SQL_MODE配置差异 #

部分Heroku的MySQL服务默认开启ONLY_FULL_GROUP_BY校验模式，你现有查询的GROUP BY d.dte在该模式下部分版本会触发校验异常，或者出现排序/聚合结果错乱。解决方案：

• 执行查询前调整会话配置：SET SESSION sql_mode = REPLACE(@@sql_mode, 'ONLY_FULL_GROUP_BY', '');
• 或者调整GROUP BY子句和SELECT非聚合字段对齐：GROUP BY DATE_FORMAT(d.dte, '%d'), d.dte

4. 核对表结构与数据一致性 #

确认Heroku端cards、people_cards表的publicated、publication_date字段的类型、默认值和本地完全一致，同时确认线上测试数据和本地测试数据的量级、内容匹配，避免因空值、数据缺失导致计数结果异常。

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