本文详解 django 应用在 vercel 等现代托管平台部署失败的常见原因，重点讲解如何按平台规范重构项目结构、配置 wsgi/asgi 入口、设置环境变量及静态文件处理，助你将本地可运行的天气应用成功上线。
本文详解 django 应用在 vercel 等现代托管平台部署失败的常见原因，重点讲解如何按平台规范重构项目结构、配置 wsgi/asgi 入口、设置环境变量及静态文件处理，助你将本地可运行的天气应用成功上线。
Django 本地开发时使用 python manage.py runserver 非常便捷，但它依赖 Django 内置的轻量开发服务器，并不适用于生产环境或无服务器（Serverless）托管平台（如 Vercel、Render、Fly.io）。你遇到的“本地能跑、线上报错”问题，绝大多数源于项目未适配目标平台的部署契约——尤其是缺少标准化入口、误用开发配置、忽略静态资源处理等。
✅ 正确部署 Vercel 的关键步骤
Vercel 对 Python/Django 应用有明确要求：它不运行 manage.py，而是直接调用 ASGI 应用实例（推荐）或 WSGI。你需要确保：
- 项目根目录包含 vercel.json 或 project.json 配置文件（定义构建命令与输出目录）；
- 提供符合标准的 ASGI 入口文件（如 asgi.py 已存在，但需确保其被正确引用）；
- *将 ALLOWED_HOSTS 动态设为 `[""]或显式包含部署域名**（Vercel 环境中常设为["*"]`，仅限测试阶段；生产请严格限制）；
- 静态文件由 Vercel 托管：禁用 DEBUG=True，运行 python manage.py collectstatic --noinput 并将 STATIC_ROOT 指向 ./staticfiles（Vercel 默认服务该目录）。
以下是最小可行的 vercel.json 配置示例：
{
"builds": [
{
"src": "myweatherapp/asgi.py",
"use": "@vercel/python",
"config": { "maxLambdaSize": "15mb" }
}
],
"routes": [
{
"src": "/static/(.*)",
"dest": "/staticfiles/$1"
},
{
"src": "/(.*)",
"dest": "myweatherapp/asgi.py"
}
]
}⚠️ 注意：src 中的 myweatherapp/asgi.py 需替换为你实际的 Django 项目包名（即包含 settings.py 的目录名）。检查你的 GitHub 仓库——当前结构中 manage.py 与 Pfefferdorn.github.io 目录同级，但缺少 vercel.json 和明确的 ASGI 入口声明，这是部署失败的直接原因。
? 必须修改的核心代码片段
在 settings.py 中，务必更新以下配置：
# settings.py
import os
from decouple import config # 推荐使用 python-decouple 管理环境变量
DEBUG = config('DEBUG', default=False, cast=bool)
SECRET_KEY = config('SECRET_KEY')
ALLOWED_HOSTS = config('ALLOWED_HOSTS', default='*').split(',')
# 静态文件配置（Vercel 要求）
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') # 构建时 collectstatic 输出目录
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]同时，在 asgi.py 顶部确认 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myweatherapp.settings') 中的 'myweatherapp' 与你的项目包名完全一致。
? 总结与建议
- ❌ 不要试图在 Vercel 上运行 runserver 或依赖 manage.py 启动；
- ✅ 严格遵循 Vercel Django 模板 的目录结构与配置逻辑；
- ✅ 使用 python-decouple 或 django-environ 管理环境变量，避免硬编码；
- ✅ 部署前本地模拟：运行 collectstatic → 启动 gunicorn myweatherapp.asgi:application 测试 ASGI 入口是否可用；
- ✅ 初次部署失败时，务必查看 Vercel 控制台的 Build Logs 和 Function Logs，错误信息通常直指缺失的入口文件或模块导入异常。
完成上述调整后，推送代码至 GitHub，Vercel 将自动触发构建并部署你的天气应用——此时它不再只是本地的 http://127.0.0.1:8000，而是真正可公开访问的 Web 服务。
