Django3.2.5对接MySQL5.7出现UNION语法错误是否为兼容性问题？

这个报错本质是Django 3.2.x的UNION语法生成逻辑和MySQL 5.7的SQL语法限制不兼容导致的。

根本原因 #

• MySQL 5.7不支持多层嵌套UNION语句的外层括号语法，你打印出来的SQL结构为((SELECT ... UNION SELECT ...) UNION SELECT ...)，这种写法在MySQL 8.0及以上版本才被支持，这也是相同代码在你本地MySQL 8.0环境可以正常运行的核心原因。
• Django 3.2在链式调用union()方法时，会自动给前一次合并后的查询集整体套上括号，刚好触发了MySQL 5.7的语法校验错误。

修复方案 #

方案1：一次性合并所有查询集（最简便） #

不要分两次链式调用union()，将所有需要合并的查询集一次性传入union()方法，Django就会生成无嵌套括号的SELECT ... UNION SELECT ... UNION SELECT ...结构，兼容MySQL 5.7：

public_article_list = Article.objects.filter(
    category__name__in=categorynames, status__in=['p', 'g'])
user = self.request.user
self_article_list = Article.objects.filter(category__name__in=categorynames,
                                               type='a', status='i', author_id=user.id)
# 提前判断用户登录状态，组装要合并的查询集列表
union_qs = [self_article_list]
if user.id:
    registered_view_articles = Article.objects.filter(type='a', status='z')
    union_qs.append(registered_view_articles)
# 一次性合并所有查询集
article_list = public_article_list.union(*union_qs)

方案2：升级MySQL版本到8.0及以上 #

如果业务允许升级数据库版本，直接升级到MySQL 8.0即可原生支持这种嵌套UNION语法，不需要修改业务代码。

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