部署至DigitalOcean后Django后台页面CSS不显示问题求助

Hey there, let's work through this admin CSS issue together—since you've already gone through the basic docs and guides, let's dive into deployment-specific checks that often trip folks up on DigitalOcean:

1. Verify collectstatic Actually Ran Successfully & Files Exist #

First, double-check that the static files were properly collected to your STATIC_ROOT directory. Log into your DigitalOcean droplet via SSH and run:

ls -l /path/to/your/STATIC_ROOT/admin/css/

You should see files like base.css, dashboard.css, etc. If they're missing, re-run the collectstatic command with sudo (to ensure permissions):

sudo python manage.py collectstatic

Make sure you confirm the prompt to overwrite files if asked.

2. Check Web Server (Nginx/Apache) Configuration #

DigitalOcean deployments usually use Nginx or Apache as a reverse proxy—if the server isn't configured to serve static files correctly, Django admin won't load CSS.

For Nginx: #

Open your site's Nginx config file (typically in /etc/nginx/sites-available/yourproject) and ensure you have a location block pointing to your STATIC_ROOT:

location /static/ {
    alias /path/to/your/STATIC_ROOT/;  # Use the absolute path here
    expires 30d;
    add_header Cache-Control "public, max-age=2592000";
}

After editing, test the config and restart Nginx:

sudo nginx -t
sudo systemctl restart nginx

For Apache: #

Add an alias in your Apache config or .htaccess file:

Alias /static/ /path/to/your/STATIC_ROOT/
<Directory /path/to/your/STATIC_ROOT/>
    Require all granted
</Directory>

Then restart Apache:

sudo systemctl restart apache2

3. Confirm Permissions on Static Files #

Web server processes (like www-data for Nginx/Apache) need read access to your static files. Fix permissions with:

sudo chown -R www-data:www-data /path/to/your/STATIC_ROOT/
sudo chmod -R 755 /path/to/your/STATIC_ROOT/

4. Validate Django Settings #

Double-check these critical settings in settings.py:

• DEBUG = False: When DEBUG is True, Django serves static files directly, but this is unsafe for production. Ensure it's set to False—if it was accidentally left as True, that could cause issues if your server isn't set up to handle static files in production mode.
• STATIC_URL = '/static/': This must match the path in your web server config (the location block in Nginx or Alias in Apache).
• STATIC_ROOT is an absolute path: For example:

  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  # Or directly:
  STATIC_ROOT = '/var/www/yourproject/staticfiles/'
  

5. Check Browser Developer Tools for Clues #

Open your browser's dev tools (F12 → Network tab) and reload the admin page. Look for the admin CSS files—if you see a 404 error, the path is misconfigured. If you see a 500 error, permissions or server config are likely the issue.

内容的提问来源于stack exchange，提问作者waleed