### 配置Waitress、Nginx和Django时静态文件404问题的解决方案 在使用Waitress和Nginx部署Django应用时，前端无法找到`static`目录下的样式文件（如CSS、JS等），通常是由于静态文件的路径配置不正确或未正确收集静态文件导致的。以下是解决此问题的详细方法： #### 1. 确保静态文件已正确收集 在Django项目中，静态文件需要通过`collectstatic`命令收集到指定目录下。首先检查`settings.py`文件中的相关配置是否正确。 - **STATIC_URL**：定义静态文件的URL前缀。 ```python STATIC_URL = '/static/' ``` 此配置表示静态文件可以通过`/static/`访问[^2]。 - **STATICFILES_DIRS**：定义静态文件的额外查找路径。 ```python STATICFILES_DIRS = [ os.path.join(BASE_DIR, "static"), ] ``` 这里将项目的`static`目录作为静态文件的来源之一[^2]。 - **STATIC_ROOT**：定义静态文件的最终存放位置。 ```python STATIC_ROOT = os.path.join(BASE_DIR, 'collected_static') ``` 此目录用于存储所有被收集的静态文件，通常由`collectstatic`命令生成。 运行以下命令以确保静态文件已被正确收集： ```bash python manage.py collectstatic ``` #### 2. 配置Nginx以处理静态文件 Nginx需要配置为直接提供静态文件服务，而不是将请求转发给Django。以下是Nginx配置示例： ```nginx server { listen 80; server_name your_domain_or_ip; location /static/ { alias /path/to/your/project/collected_static/; } location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ``` - `location /static/`：指定静态文件的请求路径，并将其映射到实际的静态文件目录。 - `/path/to/your/project/collected_static/`：替换为实际的`STATIC_ROOT`路径[^3]。 #### 3. 配置Waitress以运行Django应用 Waitress作为WSGI服务器负责运行Django应用。可以通过以下方式启动： - **命令行方式**： ```bash waitress-serve --listen=127.0.0.1:8000 your_project.wsgi:application ``` - **Python脚本方式**： ```python from waitress import serve from your_project.wsgi import application if __name__ == "__main__": serve(application, host="127.0.0.1", port="8000") ``` 确保Waitress监听的是本地地址，并由Nginx进行反向代理[^3]。 #### 4. 检查模板中静态文件的引用方式 在Django模板中，静态文件的引用方式应正确加载静态资源。例如： ```html {% load static %} <link rel="stylesheet" href="{% static 'css/style.css' %}"> <script src="{% static 'js/script.js' %}"></script> ``` 上述语法确保了静态文件路径正确解析为`/static/`下的子路径[^2]。 --- ### 注意事项 - 如果仍然出现404错误，请检查Nginx日志文件（通常位于`/var/log/nginx/error.log`）以定位问题。 - 确保Nginx配置文件已重新加载： ```bash sudo nginx -s reload ``` --- ### 示例代码 以下是一个完整的配置流程示例： 1. **Django配置**： ```python # settings.py STATIC_URL = '/static/' STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")] STATIC_ROOT = os.path.join(BASE_DIR, 'collected_static') ``` 2. **收集静态文件**： ```bash python manage.py collectstatic ``` 3. **Nginx配置**： ```nginx server { listen 80; server_name your_domain_or_ip; location /static/ { alias /path/to/your/project/collected_static/; } location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ``` 4. **启动Waitress**： ```bash waitress-serve --listen=127.0.0.1:8000 your_project.wsgi:application ``` ---