Django执行migrate命令遇TypeError：POSTGRES_PORT为空求助

从你给出的错误栈可以直接定位问题：在settings.py的第104行，你尝试将os.getenv('POSTGRES_PORT')转换为整数，但这个环境变量没有被正确读取到，返回了None，而int()函数无法把None转成整数，所以抛出了这个类型错误。

下面是几个具体的解决步骤：

• 检查POSTGRES_PORT环境变量是否已设置
  先确认这个环境变量有没有在你的系统或虚拟环境中配置：

  • Windows系统：打开命令行（确保激活了虚拟环境），执行 echo %POSTGRES_PORT%，看看是否输出了正确的端口号（PostgreSQL默认是5432）。
  • Linux/macOS系统：激活虚拟环境后执行 echo $POSTGRES_PORT，验证输出值。
    如果没有输出，说明环境变量没设置，需要手动添加。

• 给环境变量设置默认值（最快捷的临时解决办法）
  你可以修改settings.py里的代码，让它在环境变量不存在时使用默认端口，这样就不会出现None的情况了：

  'PORT': int(os.getenv('POSTGRES_PORT', 5432)),
  

  这里把默认值设为PostgreSQL的标准端口5432，你可以根据自己的数据库配置修改这个数值。

• 确认虚拟环境的环境变量加载逻辑
  如果你是用.env文件来管理环境变量（比如配合python-dotenv库），要确保：

  1. .env文件里确实有POSTGRES_PORT=你的端口号这一行
  2. 在settings.py的开头已经加载了.env文件，比如：

     from dotenv import load_dotenv
     load_dotenv()
     

  如果没有用python-dotenv，那要确保激活虚拟环境后，环境变量能被正确读取到——有些虚拟环境的激活脚本不会自动继承系统环境变量，可能需要你手动在激活脚本里添加环境变量配置。

另外，你用的Django 2.0.3版本对环境变量的处理逻辑和后续版本没有本质区别，核心问题就是环境变量未被正确获取导致的类型错误，按照上面的步骤排查应该就能解决。

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