Django项目基于pyodbc连接MSSQL实现原生SQL联表查询时渲染结果缺失字段问题求助

三个叠加问题导致页面渲染不出值，和SQL Server本身的JOIN语法、phpMyAdmin示例不通用没有直接关联，都是接口对接层的规则不匹配：

• pyodbc默认返回的结果是纯元组结构，不是带字段属性的对象，模板里用datadisplay.client_id这种点语法根本取不到值，所有值都是靠SQL查询的字段顺序按索引存储的
• SQL查询里Company表的字段直接选了原生Company.name，没有设置和模板匹配的company_name别名，两边字段标识对不上
• 全局初始化的单连接、单游标没有做请求级生命周期隔离，高并发场景下会出现游标被其他请求覆盖、连接超时失效，也是偶发字段值缺失的隐患

1. 对齐SQL字段别名和模板取值预期 #

SQL里直接选Company.name不设别名，模板却要取company_name，必须在查询语句里给字段加上对应别名，匹配模板的取值逻辑：

select 
  Client.Client_id as client_id,
  Company.name as company_name,
  Client.first_name as first_name,
  Client.last_name as last_name,
  Client.ph_no as ph_no,
  Client.tele as tele,
  Client.mail as mail,
  Client.IsActive as IsActive,
  Client.last_update as last_update
from Client
join Company on Client.company_id = Company.company_id

注意：SQL Server对返回字段名的大小写严格匹配，不要随意改动字段名的大小写，避免pyodbc读取列名时出现匹配偏差。

2. 配置pyodbc游标为字段名映射模式 #

默认的pyodbc游标返回元组，模板的点取值逻辑完全无效，只要在初始化游标时加一行配置，让返回结果支持按字段名取值，就能和模板适配：
把之前的全局游标初始化逻辑替换为以下配置：

cursor = con.cursor()
# 核心配置：把元组结果转成带字段名映射的字典，支持模板点取值
cursor.row_factory = lambda cursor, row: {col[0]: row[idx] for idx, col in enumerate(cursor.description)}
cursor.autocommit = False

关键避坑：不要把数据库连接和游标写在模块全局作用域
Django是多线程处理请求的，全局的单游标在并发时会出现数据竞争：比如A请求还没取完结果，游标就被B请求的查询覆盖了，直接导致字段值错乱、缺失。正确的做法是把连接、游标的初始化逻辑放到视图函数内部，每次请求时新建连接、执行查询、用完关闭，完全避免状态污染，修正后的视图代码参考：

def showclient(request):
    # 每次请求单独建立连接，杜绝全局连接的并发问题
    con = pyodbc.connect('Driver={SQL server};'
                         'Server=你的SQL Server实例地址;'
                         'Database=Shipping;'
                         'Trusted_Connection=True;')
    cursor = con.cursor()
    # 配置字典返回模式
    cursor.row_factory = lambda cursor, row: {col[0]: row[idx] for idx, col in enumerate(cursor.description)}
    
    sql_join_client = '''
    select 
      Client.Client_id as client_id,
      Company.name as company_name,
      Client.first_name as first_name,
      Client.last_name as last_name,
      Client.ph_no as ph_no,
      Client.tele as tele,
      Client.mail as mail,
      Client.IsActive as IsActive,
      Client.last_update as last_update
    from Client
    join Company on Client.company_id = Company.company_id
    '''
    
    try:
        cursor.execute(sql_join_client)
        result = cursor.fetchall()
    finally:
        # 查询完成主动关闭连接，避免连接泄漏
        con.close()
    
    return render(request, 'client.html', {'Client': result})

3. 模板适配验证 #

Django模板原生支持用点语法取字典的键值，完成上面的游标配置后，你原来模板里写的{{datadisplay.client_id}}、{{datadisplay.company_name}}不需要任何修改，就能正常渲染出值。
如果不做字典映射配置，也可以用元组索引的方式取值，但这种方式维护性极差——只要SQL的字段顺序调整，模板就要同步修改，完全不推荐：

<!-- 非推荐写法：按元组索引取值，字段顺序变更就会全部错位 -->
<td>{{datadisplay.0}}</td>
<td>{{datadisplay.1}}</td>

• SQL Server的JOIN语法和MySQL（phpMyAdmin默认管理的数据库）没有本质差异，唯一需要注意的是如果表名、字段名和SQL Server关键字重名，需要用方括号[]包裹标识，不要用MySQL的反引号包裹
• 你的models.py字段定义和实际数据库表有差异（比如Company模型没有company_id主键、Client模型没有client_id、last_update字段），因为你是用原生SQL查询，完全不依赖Django ORM的表结构映射，不需要为此调整模型、执行migrate操作，不会影响原生SQL的执行
• 不要为了图方便把数据库连接设成全局单例，哪怕加了自动重连逻辑，多线程下的游标数据竞争还是会偶发出现字段值缺失、数据错乱的问题，每次请求新建连接是成本最低、稳定性最高的方案

内容的提问来源于stack exchange，提问作者Indrajeet Singh Yadav