Oracle数据库的Django项目实现分页遇ORA-00933错误求助

这个问题我之前帮朋友排查过，本质是Django默认的LimitOffsetPagination生成的SQL语法在Oracle视图上存在兼容性问题，导致Oracle抛出"SQL command not properly ended"错误。下面是具体的分析和可行解决方案：

问题原因 #

Django 2.x版本的LimitOffsetPagination针对Oracle生成的分页SQL，会使用OFFSET ... FETCH NEXT ...语法（或者老版本的ROWNUM嵌套结构），但对于Oracle视图来说，这种嵌套查询的结构很容易和视图本身的定义（比如包含复杂子查询、聚合逻辑）冲突，尤其是当视图没有显式主键时，Oracle无法正确解析Django生成的SQL语句。你降级到Django 2.0.6没用，是因为这个版本本身就存在Oracle视图分页的兼容性bug，并非版本越旧越稳定。

解决方案 #

方案1：给模型添加显式主键 #

首先检查你的MyOrmModel是否定义了主键。如果Django模型没有显式主键，它会自动添加一个隐式的id字段，但这会导致生成的SQL包含额外的字段，和Oracle视图的结构不匹配，进而触发语法错误。

修改模型，添加视图中实际存在的唯一标识字段作为主键：

class MyOrmModel(models.Model):
    # 替换成你视图中真实的唯一字段，比如id、record_id等
    id = models.IntegerField(primary_key=True)
    # 其他字段根据视图结构逐一定义
    log_content = models.TextField()
    create_time = models.DateTimeField()
    
    class Meta:
        db_table = 'target_oracle_view'
        managed = False

方案2：升级Django和cx-Oracle版本 #

你的当前版本组合（Django 2.0.6 + cx-Oracle 7.3.0）对Oracle的支持不够完善，建议升级到同系列的LTS版本和兼容的cx-Oracle版本：

• Django升级到2.2.x LTS（比如2.2.28），这个版本修复了大量Oracle相关的兼容性问题
• cx-Oracle升级到8.x版本（比如8.3.0），更好地支持Oracle 12c+的语法特性

修改requirements.txt：

Django==2.2.28
cx-Oracle==8.3.0
# 其他依赖保持不变

方案3：自定义Oracle兼容的分页类 #

如果上述方案都无效，就需要手动构造符合Oracle语法的分页查询，绕过Django默认的SQL生成逻辑：

from rest_framework.pagination import LimitOffsetPagination
from .models import MyOrmModel

class OracleViewLimitOffsetPagination(LimitOffsetPagination):
    def paginate_queryset(self, queryset, request, view=None):
        limit = self.get_limit(request)
        offset = self.get_offset(request)
        
        # 如果没有限制，直接返回所有结果
        if limit is None:
            return list(queryset)
        
        # 构造Oracle传统的ROWNUM分页SQL，避免语法冲突
        # 注意：如果视图字段和模型字段不完全一致，需要把SELECT *替换成具体字段列表
        pagination_sql = """
        SELECT * FROM (
            SELECT inner_query.*, ROWNUM AS rn FROM (
                SELECT * FROM target_oracle_view
            ) inner_query WHERE ROWNUM <= %s
        ) WHERE rn > %s
        """
        # 计算分页参数：offset + limit是最大行数，offset是起始偏移
        params = [offset + limit, offset]
        # 使用RawQuerySet执行查询
        raw_queryset = MyOrmModel.objects.raw(pagination_sql, params)
        
        # 处理总计数（用于返回分页元数据）
        self.count = queryset.count()
        self.request = request
        
        return list(raw_queryset)

然后在视图集中使用这个自定义分页类：

class LogRecordNewItemViewSet(ListModelMixin, GenericViewSet):
    serializer_class = YourSerializerClass  # 替换成你的序列化器类
    pagination_class = OracleViewLimitOffsetPagination
    
    def get_queryset(self):
        return MyOrmModel.objects.all()

总结 #

优先尝试方案1和方案2，这两个是最简洁的解决方式；如果还是报错，再用方案3的自定义分页类来强制适配Oracle的语法要求。

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