无法在settings.py中导入.py文件致Apache 500错误排查

问题根源 #

settings.py的加载环境和普通Python脚本完全不同：Apache运行Django时的工作目录、环境变量、权限与你本地运行脚本时不一致，导致导入失败或Azure认证出错。

具体修复步骤 #

1. 解决导入路径问题（ModuleNotFoundError）

不要直接用import test，改用以下两种方式确保路径正确：

• 相对导入（适用于settings和test同属一个项目包的情况）：

  from . import test
  Pass = test.Pass
  

• 手动添加路径（避免PYTHONPATH在Apache环境不生效）：

  import os
  import sys
  # 将settings.py所在目录添加到Python路径
  sys.path.append(os.path.dirname(os.path.abspath(__file__)))
  import test
  Pass = test.Pass
  

2. 修复Azure认证上下文问题（ValueError）

单独运行test.py时你的环境有正确的Azure认证配置，但Apache运行时可能缺失：

• 显式指定认证参数：在test.py里直接写入认证信息（注意不要提交到代码仓库，可配合环境变量）：

  from azure.keyvault.secrets import SecretClient
  from azure.identity import ClientSecretCredential
  
  # 替换为你的Azure信息
  credential = ClientSecretCredential(
      tenant_id="你的租户ID",
      client_id="你的应用ID",
      client_secret="你的应用密钥"
  )
  client = SecretClient(vault_url="https://你的密钥库名称.vault.azure.net/", credential=credential)
  Pass = client.get_secret("目标密钥名称").value
  

• 给Apache添加环境变量：在Apache的虚拟主机配置或httpd.conf中加入Azure认证所需的环境变量：

  SetEnv AZURE_TENANT_ID "你的租户ID"
  SetEnv AZURE_CLIENT_ID "你的应用ID"
  SetEnv AZURE_CLIENT_SECRET "你的应用密钥"
  

3. 延迟加载密钥，避免settings初始化冲突

settings.py是Django启动时最早加载的文件之一，此时外部服务依赖可能未就绪，建议把密钥获取逻辑改成函数延迟调用：

# test.py
def get_db_password():
    from azure.keyvault.secrets import SecretClient
    from azure.identity import DefaultAzureCredential
    credential = DefaultAzureCredential()
    client = SecretClient(vault_url="https://你的密钥库名称.vault.azure.net/", credential=credential)
    return client.get_secret("数据库密码密钥").value

# settings.py
from . import test
# 在需要使用的地方调用函数，而不是提前赋值
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'your_db',
        'USER': 'your_user',
        'PASSWORD': test.get_db_password(),
        'HOST': 'localhost',
    }
}

4. 检查Apache运行用户权限

确保Apache运行用户（如www-data）：

• 有读取test.py文件的权限
• 能访问Azure认证凭据文件（如~/.azure/credentials，若使用默认凭据链）
• 服务器网络可正常连接Azure Key Vault服务

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