如何使用Gunicorn启动CKAN 2.9.X？应用加载失败问题排查

报错Failed to find application object: 'app'的核心原因是wsgi.py逻辑有误：所有CKAN应用初始化代码都放在了if __name__ == "__main__":判断块内。Gunicorn启动时是导入wsgi模块而非直接运行该脚本，该判断块下的代码不会执行，app变量始终为初始值None，自然无法被Gunicorn识别加载。

1. 修正wsgi.py配置 #

将应用初始化逻辑移出主程序判断块，保证应用实例是模块级变量，可被Gunicorn直接导入。参考配置如下，注意根据实际部署路径调整ckan.ini的位置：

import os
import sys
from ckan.config.middleware import make_app
from ckan.cli import CKANConfigLoader
from logging.config import fileConfig as loggingFileConfig

# 把wsgi.py所在目录加入Python导入路径，避免找不到ckan模块
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))

# 填写ckan.ini的绝对路径，示例为wsgi.py与ckan.ini同目录
config_filepath = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'ckan.ini')
# 加载日志配置
loggingFileConfig(config_filepath)
# 加载CKAN配置
config = CKANConfigLoader(config_filepath).get_config()
# 初始化WSGI应用实例
application = make_app(config)

注：CKAN生态默认使用application作为WSGI实例名，如果你想沿用app作为变量名直接修改即可，启动命令对应调整参数。

2. 启动前校验 #

启动前必须激活CKAN部署所用的Python虚拟环境，确认虚拟环境内已安装匹配版本的Gunicorn，避免依赖冲突：

# 替换为你自己的虚拟环境激活路径
source /usr/lib/ckan/venv/bin/activate
# 校验gunicorn安装状态
pip show gunicorn

3. 启动命令 #

如果wsgi.py中使用application作为实例名，执行以下命令启动：

gunicorn --bind 0.0.0.0:5000 wsgi:application --workers 4 --timeout 120

如果使用app作为实例名，将命令中wsgi:application替换为wsgi:app即可。
常用参数说明：

• --workers：工作进程数，建议设置为服务器CPU核心数*2+1，不要设置过大避免内存溢出
• --timeout：CKAN部分后台任务（比如资源导入、索引重建）耗时较长，建议超时时间设置为120秒以上，避免请求被中途切断

4. Supervisor托管配置（可选） #

如果需要用Supervisor托管Gunicorn进程，实现开机自启、异常自动重启，可在/etc/supervisor/conf.d/ckan.conf写入以下配置，所有路径替换为实际部署路径：

[program:ckan]
command=/usr/lib/ckan/venv/bin/gunicorn --bind 127.0.0.1:5000 wsgi:application --workers 4 --timeout 120
directory=/path/to/your/wsgi/file/directory
user=www-data
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/ckan/gunicorn.log

配置写入后执行以下命令加载生效：

supervisorctl reread
supervisorctl update
supervisorctl start ckan

• 生产环境不要直接用root用户运行Gunicorn，建议使用专门的web服务用户（比如www-data）运行，避免权限风险和静态资源读取问题
• 不要将Gunicorn直接暴露在公网，前端需要搭配Nginx做反向代理，处理静态资源响应、SSL卸载、请求限流等逻辑
• 如果启动时提示找不到ckan模块，先确认是否激活了正确的虚拟环境，再检查wsgi.py中是否将项目目录加入了Python导入路径
• 如果启动后报配置文件、静态资源目录无权限，给运行Gunicorn的用户分配对应目录的读权限即可

内容的提问来源于stack exchange，提问作者QLands - Carlos Quiros