Python警告选项'once'参数失效求助（Django1.10/Python3.5.3）

我之前也碰到过类似框架覆盖警告设置的问题，给你几个具体的排查和解决方向：

• 先排查Django是否默认覆盖了警告规则
  Django在启动过程中（比如导入核心模块时）可能会自动设置自身的警告过滤器，优先级比环境变量更高。你可以在项目的manage.py最顶部，导入Django之前手动重新设置警告规则：

  import warnings
  # 全局设置每条警告仅显示一次
  warnings.simplefilter('once')
  # 如果只想针对特定警告类别生效，比如DeprecationWarning
  # warnings.simplefilter('once', DeprecationWarning)
  
  # 后续保留原有manage.py代码
  import os
  import sys
  
  if __name__ == "__main__":
      os.environ.setdefault("DJANGO_SETTINGS_MODULE", "your_project.settings")
      from django.core.management import execute_from_command_line
      execute_from_command_line(sys.argv)
  

• 确认PYTHONWARNINGS环境变量的格式是否正确
  有时候看似正确的参数，可能因为格式细节不达标而失效。如果要全局生效，正确的设置方式是：

  # Linux/macOS终端
  export PYTHONWARNINGS="once"
  # Windows命令行
  set PYTHONWARNINGS=once
  

  如果需要针对特定警告类别或模块生效，要遵循action:message:category:module:lineno的格式，比如只对Django的DeprecationWarning生效：

  export PYTHONWARNINGS="once::DeprecationWarning:django.*"
  

• 排除第三方库或项目代码的干扰
  检查你的项目代码或依赖的第三方库中，有没有其他地方调用了warnings.filterwarnings()或warnings.simplefilter()，这些调用会直接覆盖环境变量的设置。可以在项目启动的关键节点（比如settings.py开头）打印当前的警告过滤器列表，确认是否有意外规则：

  import warnings
  print(warnings.filters)  # 打印当前所有警告过滤器规则
  

• 纯Python环境验证'once'参数是否正常
  先脱离Django环境测试，确认Python本身的'once'功能没问题。写一个简单的测试脚本：

  import warnings
  
  def trigger_warning():
      warnings.warn("测试警告内容", UserWarning)
  
  # 连续触发三次警告
  trigger_warning()
  trigger_warning()
  trigger_warning()
  

  用环境变量启动脚本：PYTHONWARNINGS="once" python test.py，如果只输出一次警告，说明Python本身功能正常，问题肯定出在Django或项目代码的警告设置覆盖上。

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