编辑“︁Django开发服务器”︁

= Django开发服务器 =

Django开发服务器（Development Server）是Django框架内置的一个轻量级Web服务器，专为开发环境设计。它允许开发者在本地快速运行和测试Django项目，无需配置复杂的生产环境服务器（如Nginx或Apache）。

== 概述 ==
Django开发服务器基于Python的`http.server`模块构建，具有以下特点：
* 自动检测代码变更并重新加载（无需手动重启）
* 支持静态文件服务（需配置`STATIC_URL`）
* 提供详细的错误信息和调试页面
* 仅限本地开发使用（性能不足以支撑生产环境）

== 启动开发服务器 ==
使用`manage.py`的`runserver`命令启动服务器：

<syntaxhighlight lang="bash">
# 默认端口8000
python manage.py runserver

# 指定端口
python manage.py runserver 8080

# 监听所有网络接口（允许局域网访问）
python manage.py runserver 0.0.0.0:8000
</syntaxhighlight>

成功启动后会显示：
<syntaxhighlight lang="text">
Watching for file changes with StatReloader
Performing system checks...
System check identified no issues (0 silenced).
Django version 4.2, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
</syntaxhighlight>

== 工作原理 ==
<mermaid>
graph TD
    A[runserver命令] --> B[加载Django配置]
    B --> C[检查模型和路由]
    C --> D[启动WSGI应用]
    D --> E[监听指定端口]
    E --> F[处理HTTP请求]
    F --> G[返回响应]
</mermaid>

关键组件：
* '''WSGI处理器'''：处理HTTP请求的Python WSGI接口
* '''自动重载器'''：通过文件系统监视实现代码热更新
* '''请求日志'''：在控制台输出所有访问记录

== 高级配置 ==
=== 自定义服务器行为 ===
通过`--nostatic`禁用静态文件服务：
<syntaxhighlight lang="bash">
python manage.py runserver --nostatic
</syntaxhighlight>

=== 多线程模式 ===
Django 3.2+支持多线程处理请求（默认启用）：
<syntaxhighlight lang="bash">
python manage.py runserver --threaded
</syntaxhighlight>

数学公式示例（服务器吞吐量计算）：
<math>
Q = \frac{N}{T}
</math>
其中：
* <math>Q</math> 是吞吐量（请求/秒）
* <math>N</math> 是处理的请求数
* <math>T</math> 是总时间（秒）

== 实际案例 ==
'''场景'''：开发一个博客系统时实时预览修改

1. 修改`models.py`添加新字段：
<syntaxhighlight lang="python">
class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    # 新增字段
    is_published = models.BooleanField(default=False)
</syntaxhighlight>

2. 开发服务器会自动检测到变更：
<syntaxhighlight lang="text">
System check identified some issues:
WARNINGS:
blog.Post.is_published: (fields.W342) Setting unique=True on a ForeignKey has the same effect as using a OneToOneField.
</syntaxhighlight>

3. 创建并应用迁移：
<syntaxhighlight lang="bash">
python manage.py makemigrations
python manage.py migrate
</syntaxhighlight>

4. 服务器保持运行状态，无需重启即可测试新功能

== 限制与注意事项 ==
* '''性能限制'''：单线程模式（默认）只能处理约10-20个并发请求
* '''安全警告'''：开发服务器未实现生产级安全防护
* '''静态文件'''：仅适用于开发环境，生产环境需使用专用Web服务器
* '''数据库连接'''：长时间运行可能导致数据库连接超时

== 故障排除 ==
{| class="wikitable"
|+ 常见问题解决方案
|-
! 问题 !! 解决方案
|-
| 端口被占用 || 更换端口：<code>runserver 8080</code>
|-
| 修改未生效 || 检查是否保存文件，或手动重启服务器
|-
| 无法访问 || 检查防火墙设置，或使用<code>0.0.0.0:8000</code>
|}

== 最佳实践 ==
1. 仅用于开发环境
2. 配合版本控制使用（如Git）
3. 定期检查控制台输出的警告信息
4. 重要修改后建议手动重启服务器

开发服务器是Django开发者最高效的工具之一，合理使用可以显著提升开发效率。

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django基础]]