部署Flask应用到Heroku时出现No module named 'fcntl'错误如何解决？

首先明确ModuleNotFoundError: No module named 'fcntl'报错的根因：
fcntl是类Unix系统专属的系统调用模块，gunicorn本身不支持Windows运行环境，你在本地Windows环境执行gunicorn命令触发该报错属于正常现象，和你的Flask项目代码无关，也和Heroku云端的运行报错没有关联，不需要针对该报错做任何代码适配。

你需要聚焦解决Heroku云端的Worker failed to boot报错，这是触发503状态码的核心原因，按以下优先级逐一排查：

• 检查项目根目录的Procfile配置：文件名称必须为Procfile（无后缀、首字母大写），启动指令的Flask实例名必须和你代码中的实际实例名完全匹配。例如你代码中定义的是app = Flask(__name__)，则Procfile内容应为web: gunicorn app:app；如果你将实例命名为application，才需要写为web: gunicorn app:application，实例名写错是这类报错最高发的原因。
• 检查requirements.txt内容：必须显式包含gunicorn依赖，很多开发者本地用Flask自带服务器调试，忘记将gunicorn加入依赖列表，会导致Heroku环境找不到启动程序触发崩溃。
• 检查代码启动入口：代码中所有app.run()逻辑必须包裹在if __name__ == '__main__':判断中，否则gunicorn导入代码时会直接执行Flask开发服务器，触发端口冲突导致启动失败。
• 检查环境变量配置：执行heroku config查看Heroku后台配置的环境变量，确认你代码中用到的所有敏感配置、第三方服务链接等都已正确配置，缺失环境变量会直接导致代码初始化失败。

本地排查不需要运行gunicorn，直接用flask run启动开发服务器验证代码逻辑即可，确认本地无报错后重新推送到Heroku，再通过heroku logs --tail查看云端启动的具体报错信息定位问题。

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