SAE (Sina App Engine) 是新浪雲平台,支援 Python 應用部署。早期版本對 Django 支援有諸多限制,本文記錄實戰踩坑經驗 (基於 Django 1.3~1.4 時代,現代部署建議參考最新文檔)。
現象:SAE 內建 Django 1.2.x,專案需 1.3+。
解決:自帶 Django 套件,配置虛擬環境。
# 專案結構
myproject/
├── index.wsgi # SAE 入口
├── requirements.txt # Django==1.4.22 等
├── lib/ # 放置第三方套件 (或用 virtualenv)
│ └── django/
└── myproject/
├── settings.py
└── wsgi.py
# index.wsgi - 關鍵:調整 sys.path 優先載入自帶套件
import sys
import os
# 將 lib 目錄插入最前面
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'lib'))
import sae
from myproject.wsgi import application
application = sae.create_wsgi_app(application)
現象:AdminEmailHandler 初始化報錯 TypeError: __init__() got unexpected keyword argument 'is_mail'。
原因:SAE 環境的 Django 版本與專案設定不兼容。
解決:在 settings.py 禁用有問題的 handler:
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'null': {
'level': 'DEBUG',
'class': 'django.utils.log.NullHandler', # 關鍵:替換有問題的 handler
},
'console': {
'level': 'DEBUG',
'class': 'logging.StreamHandler',
},
},
'loggers': {
'django.request': {
'handlers': ['null', 'console'],
'level': 'ERROR',
'propagate': True,
},
},
}
現象:執行緒區域儲存失效。
解決:在 index.wsgi 最早期注入補丁:
import threading
from django.utils import _threading_local
threading.local = _threading_local.local
現象:SAE 預載入 django-userena 示範專案,其 settings.py 優先級高於專案。
解決:重命名專案設定檔避開衝突:
# 將 settings.py 改為 qnotes_settings.py
# index.wsgi 中指定
os.environ['DJANGO_SETTINGS_MODULE'] = 'myproject.qnotes_settings'
現象:OperationalError: (1045, 'access denied') 間歇性出現。
原因:SAE MySQL 不支援長連接,30 秒空閒斷開。Django 預設連接重用機制與此衝突。
解決:
# settings.py
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'CONN_MAX_AGE': 0, # 關鍵:關閉持久連接,每請求新建
# 其他設定...
}
}
或使用 django-db-geventpool 等連接池方案。
sys.path 行為異常,務必在 index.wsgi 明確控制路徑優先級SAE 已較少用於新專案,推薦替代方案:
requirements.txtvirtualenv 隔離依賴CONN_MAX_AGE = 0 適配短連接環境