Django基础教程（137）Django部署上线之Django部署前的准备：Django代码要冲上云霄？别急！部署前的这波神操作，让你和Bug说再见！

嘿，各位Django侠客！是不是已经在本地的127.0.0.1:8000里把自己的大作打磨得闪闪发光，感觉即将走上人生巅峰，只差临门一脚——部署上线了？

别急，兄弟！我知道你现在的心情，就像好不容易考了驾照，迫不及待想上高速飙车。但请先踩一脚刹车！直接从开发模式冲向生产环境，大概率不是“速度与激情”，而是“翻车与绝望”。

部署，不是简单地把代码扔到服务器了事。它是一场精心的“搬家”仪式。今天，咱就泡上一杯枸杞茶，坐下来好好聊聊，在按下那个神圣的git push之前，你必须做完的“出征准备”。

第一章：心态调整：从“自家后院”到“星辰大海”

在本地，你是上帝。runserver 命令一响，服务器秒开，DEBUG = True 这个“金钟罩”让你所有错误都一目了然。

但在生产环境？你就是个“物业管理员”。用户可不会容忍一个白花花的错误页面，或者一个加载不出CSS的“裸奔”网站。所以，第一步，收起你的开发者傲娇，换上运维者的严谨。

核心思想：生产环境 ≠ 开发环境。一切求稳、求安全、求性能。

第二章：出征前的五大“神装”准备（附代码示例）

假设我们的项目名叫 MyAwesomeSite，结构如下：

MyAwesomeSite/
├── manage.py
├── MyAwesomeSite/
│   ├── __init__.py
│   ├── settings.py  <-- 今天的主角！重点改造对象！
│   ├── urls.py
│   └── wsgi.py      <-- 另一个关键先生！
├── requirements.txt <-- 马上创建它！
└── static/
    └── ... (我们的CSS, JS, 图片)

神装一：环境变量——把敏感信息“藏”起来

在开发时，你是不是把SECRET_KEY、数据库密码等直接写在settings.py里了？这就像把银行卡密码写在朋友圈，上线后分分钟被黑客“送走”。

解决方案：使用环境变量。

1. 安装 python-decouple：

pip install python-decouple

1. 在项目根目录创建 .env 文件：

# .env 文件 - 这个文件千万不要提交到Git！
DEBUG=False
SECRET_KEY=your-super-long-ultra-secret-key-generated-by-you
DATABASE_URL=postgres://myuser:mypassword@localhost/mydatabase
ALLOWED_HOSTS=.yourdomain.com,localhost,127.0.0.1

注意：.env 一定要加到 .gitignore 里！

1. 改造 settings.py：

# MyAwesomeSite/settings.py
from decouple import config, Csv

# 原来：SECRET_KEY = 'django-insecure-...'
# 现在：
SECRET_KEY = config('SECRET_KEY')

# 原来：DEBUG = True
# 现在：
DEBUG = config('DEBUG', default=False, cast=bool)

# 原来：ALLOWED_HOSTS = []
# 现在：
ALLOWED_HOSTS = config('ALLOWED_HOSTS', cast=Csv())

看，这样一来，你的核心机密就和代码分家了。服务器上只需要配置好同样的环境变量，代码就能安全运行。

神装二：静态文件与媒体文件——给网站“穿上衣服”

在开发时，runserver 好心帮你处理了CSS、JS这些静态文件。但在生产环境，这个“好心人”下班了。你必须找一个专门的“服装管理员”（比如Nginx）来打理它们。

1. 配置静态文件路径：

# settings.py
# ... 其他配置 ...

# 指定所有App的静态文件收集到这里
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') # 新增这行！

# 媒体文件（用户上传的）
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

1. 使用 collectstatic 命令“收衣服”：
   在服务器上，你会运行这个命令：

python manage.py collectstatic

这个命令会把所有散落在各App里的静态文件，统统收集到 STATIC_ROOT 指定的 staticfiles 文件夹里。然后，你就可以配置Nginx，让它直接对外提供这个文件夹的服务，效率飙升！

神装三：数据库——从“小推车”升级到“大卡车”

开发时用轻量级的SQLite没问题，但生产环境最好用更强大的，比如PostgreSQL或MySQL。

1. 安装数据库驱动，比如PostgreSQL就用 psycopg2：

pip install psycopg2-binary

1. 在 settings.py 中配置（继续使用环境变量）：

# 使用 dj-database-url 包可以更方便地解析 DATABASE_URL
# pip install dj-database-url
import dj_database_url

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

# 覆盖默认配置，如果存在 DATABASE_URL 环境变量（生产环境）
DATABASES['default'] = dj_database_url.config(
    default=config('DATABASE_URL'),
    conn_max_age=600,
    ssl_require=not DEBUG
)

这样，在本地没有DATABASE_URL时，它依然会用SQLite；而在服务器上设置了DATABASE_URL，就会自动切换到PostgreSQL。

神装四：WSGI配置——启动强大的“引擎”

runserver 是玩具车，生产环境需要跑车引擎。这就是 WSGI。

你的项目里已经有一个 wsgi.py 文件了，它就是你的“引擎启动器”。在生产环境，我们会用像 Gunicorn 或 uWSGI 这样的专业服务器来运行这个文件。

# 安装Gunicorn
pip install gunicorn

# 在服务器上，你会这样启动你的项目（在项目根目录）：
gunicorn --bind 0.0.0.0:8000 MyAwesomeSite.wsgi:application

神装五：依赖清单——打包你的“行军粮草”

你肯定不想在服务器上一个一个pip install吧？requirements.txt 就是你的物资清单。

生成它！

# 在本地开发环境，执行：
pip freeze > requirements.txt

这个命令会把你当前虚拟环境下所有安装的包和版本号记录下来。到了服务器，只需要一句：

pip install -r requirements.txt

就能完美复刻你的开发环境，避免“在我机器上是好的”这种世界性难题。

第三章：完整示例：一个“战备状态”的settings.py

光说不练假把式，下面是一个精简但已做好部署准备的 settings.py 示例：

"""
MyAwesomeSite 的生产就绪配置
"""
import os
from decouple import config, Csv
import dj_database_url

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = config('SECRET_KEY')

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = config('DEBUG', default=False, cast=bool)

# 允许访问的主机/域名
ALLOWED_HOSTS = config('ALLOWED_HOSTS', cast=Csv())

# Application definition
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles', # 必须要有！
    'myapp', # 你的自定义App
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware', # 新增！用于处理静态文件
    # ... 其他中间件 ...
]

ROOT_URLCONF = 'MyAwesomeSite.urls'

# ... TEMPLATES 配置 ...

# Database
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}
# 用环境变量的数据库配置覆盖默认配置
db_from_env = dj_database_url.config(conn_max_age=600)
DATABASES['default'].update(db_from_env)

# 静态文件配置 (CSS, JavaScript, Images)
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
# 使用Whitenoise让Gunicorn也能高效服务静态文件
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

# 媒体文件
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

# 日志配置（非常重要！生产环境没有Debug页面，靠它定位问题）
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'ERROR',
            'class': 'logging.FileHandler',
            'filename': os.path.join(BASE_DIR, 'logs/django_error.log'),
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'ERROR',
            'propagate': True,
        },
    },
}

# 其他设置...

注意：上面的示例中引入了 whitenoise，记得 pip install whitenoise 并把它加到 requirements.txt。它在某些简单场景下可以替代Nginx处理静态文件，非常方便。

第四章：最后的出征检查清单

• DEBUG = False （通过环境变量）
• 设置了又长又复杂的 SECRET_KEY
• ALLOWED_HOSTS 填上了你的域名或服务器IP
• 数据库已从SQLite切换为PostgreSQL/MySQL
• STATIC_ROOT 和 MEDIA_ROOT 已配置
• requirements.txt 已更新
• 在本地测试过 collectstatic 命令
• 检查了 urls.py 和 views.py，没有硬编码的本地URL
• 创建了 logs/ 目录用于存放日志文件

结语

好了，老铁！经过这一番“梳妆打扮”，你的Django项目已经从“居家服”换上了“战斗铠甲”。它不再是那个只能在localhost里自嗨的玩具，而是一个真正准备好迎接互联网风雨的战士。

虽然前面还有配置服务器（Nginx）、设置进程守护（Systemd）等关卡，但你已经完成了最核心、最容易出错的一步。俗话说“磨刀不误砍柴工”，这份细致的准备工作，将为你后续的部署之路扫清无数障碍。

现在，深呼吸，你可以自信地开始下一步了。祝你的代码一路顺风，成功上线！如果遇到问题，别忘了还有日志这个“黑匣子”可以帮你。去吧，未来的全栈工程师！