Azure部署带SQL数据库的Django应用出现内部服务器错误排查

我来帮你拆解这个问题——既然不带SQL的版本能正常运行，那问题大概率出在Django与SQL数据库的连接配置或者Azure环境中数据库相关的权限/依赖上。结合你给出的IIS错误提示，咱们可以从以下几个方向逐一排查：

一、先核对Django的数据库连接配置 #

这是最容易出问题的环节，先确认settings.py里的DATABASES配置是否完全正确：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlserver',
        'NAME': '你的数据库名称',
        'USER': '你的数据库用户名@AzureSQL服务器名',
        'PASSWORD': '你的数据库密码',
        'HOST': 'AzureSQL服务器名.database.windows.net',
        'PORT': '1433',
        'OPTIONS': {
            'driver': 'ODBC Driver 17 for SQL Server',
        },
    }
}

• 重点注意：ODBC驱动版本要和Azure环境中安装的一致，推荐用ODBC 17或更高版本；
• 可以先在本地用同样的配置连接Azure SQL，确认能正常读写数据，排除连接字符串本身的问题。

二、排查Azure SQL数据库的访问权限 #

就算配置对了，权限不够也会导致连接失败：

• 检查Azure SQL服务器的防火墙规则：把Azure App Service的所有出站IP地址添加到允许列表里。你可以在App Service的「网络」选项卡找到这些出站IP，然后到Azure SQL的防火墙设置里逐个添加；
• 确认数据库用户权限：确保你用的数据库账号拥有创建表、读写数据的权限，避免Django执行migrate或查询时因为权限不足抛出错误。

三、检查IIS层面的配置与权限 #

根据你给出的IIS错误日志，还有几个点要确认：

• web.config文件权限：确保IIS应用池的身份（通常是IIS AppPool\你的应用池名称）对web.config文件有读取权限。你可以通过Azure App Service的「高级工具」→「Kudu」进入站点目录，右键web.config查看权限设置；
• .NET Extensibility Feature是否安装：如果你的App Service用的是Windows环境，可能需要启用.NET相关扩展功能。不过更推荐Python应用用Linux环境部署，能避免这类.NET依赖问题；
• 托管处理程序映射：确认Python的托管处理程序配置正确。在Kudu的site\wwwroot目录下，web.config里应该有类似这样的配置，用来处理Python请求：

  <handlers>
      <add name="PythonHandler" path="*" verb="*" modules="FastCgiModule" scriptProcessor="D:\home\Python39\python.exe|D:\home\Python39\wfastcgi.py" resourceType="Unspecified" requireAccess="Script"/>
  </handlers>
  

  如果配置缺失或路径错误，IIS就没法正确处理Django的请求。

四、查看Django的详细错误日志 #

500错误的具体原因，得看Django的日志才好定位：

• 临时开启DEBUG模式（仅限排查用，生产环境一定要关闭）：

  DEBUG = True
  ALLOWED_HOSTS = ['你的应用域名']
  

• 或者在Azure App Service的「日志」选项卡中开启「应用日志」，然后查看详细的错误信息，里面会包含Django抛出的具体异常（比如数据库连接超时、表不存在等）。

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