Django debug為True時,css加載失敗的解決方案

Posted on by

django上線後，需要把setting.py文件的debug=True改為False，以防暴露代碼報錯問題。

因為我項目用到css的地方隻有admin管理員登陸這塊，沒有自定義的css等，所以我的css文件夾名稱定義成static

1.更改setting.py文件

STATIC_URL=‘/static/‘
STATIC_ROOT=os.path.join(BASE_DIR,'../static/')

STATIC_URL是css的加載路徑，項目中如果用到瞭css的地方，會沿著該路徑尋找這個路徑下的css文件

STATIC_ROOT是存放所有的static文件，運行 python manage.py collectionstatic命令後，python會自動檢索項目所有的目錄，把static文件夾拷貝到STATIC_ROOT目錄下。在部署的時候會用到。

2.執行下述命令

將所有的所有app下（包括Django自帶的）static目錄下的文件復制到STATIC_ROOT目錄下

python manage.py collectionstatic

3.修改nginx配置文件

添加下述代碼到nginx配置文件中

location /static {
    alias /Users/admin/PythonProject/static;
    break;
    }

server結果如下

server{
        listen 8011;
        server_name localhost;
        rewrite ^/$/ break;
        location /static {
            alias /Users/admin/PythonProject/static;
            break;
        }    
        location /{
            proxy_pass http://127.0.0.1:8000;
        } 
}

作用如下：當一個請求（例如，登陸請求 http://127.0.0.1:8011/admin/）通過nginx轉發時，會首先到下面的location中，被轉發到8000端口，調用Django項目中的admin登陸接口，登陸接口裡面會請求兩個css文件，分別是

http://127.0.0.1:8011/static/admin/css/login.css

http://127.0.0.1:8011/static/admin/css/base.css

這兩個請求被上面的nginx配置中的第一個location匹配到，並且使用alias路徑替換location路徑，找到login.css文件和base.css文件。

（註意：location後面配置的路徑，如果是以 / 結尾，那麼匹配後的路徑將不會帶匹配中的字段，不帶 / 結尾，將會帶著匹配中的字段，詳細的就不再贅述瞭）

這樣，css文件就會被正確的加載上瞭。

補充：Django項目關閉debug模式後,靜態文件無法加載的解決辦法

近期在做OpenStack Horizon項目的相關開發，OpenStack的整體環境使用DevStack安裝，horizon開發過程中直接使用命令：

python manager.py runserver

開啟內置服務器，由於項目中local_settings.py文件中的DEBUG=True，進行開發和調試一直沒什麼問題。

但是現在需要編寫404,500等出錯頁面，在debug模式下出瞭錯都會出現報錯頁面，無法轉向到404或500頁面，這時我將local_settings.py中的DEBUG設為false，這時候應該可以轉向到404頁面。

實驗證明確實如此，404和500頁面都可以得到，但是出現瞭新的問題：css和js文件無法加載。

在網上找瞭找，很快就找到瞭問題的原因：

Django框架僅在開發模式下提供靜態文件服務。

當我開啟DEBUG模式時，Django內置的服務器是提供靜態文件的服務的，所以css等文件訪問都沒有問題，但是關閉DEBUG模式後，Django便不提供靜態文件服務瞭。

想一想這是符合Django的哲學的：這部分事情標準服務器都很擅長，就讓服務器去做吧！

OK，解決問題的辦法也就出現瞭，我最開始想到的就是，使用項目正式部署是所使用的配置，由apache提供靜態文件服務。不過解決問題的方法遠不止一種，在stackoverflow上我發現瞭更有趣的方法。

現在把自己總結的四種方法列在下面，共大傢參考：

1.將靜態文件由apache提供文件服務(類似正式部署)：

編輯/etc/apache2/sites-available/horizon文件：

#Alias /media /opt/stack/horizon/openstack_dashboard/static
Alias /static /opt/stack/horizon/openstack_dashboard/static

建立靜態文件鏈接：

ln -sv /opt/stack/horizon/openstack_dashboard/static /opt/stack/horizon

重啟apache:

sudo service apache2 restart

2.使用django.views.static.serve()方法

在URLconf中添加：

(r'^site_media/(?P<path>.*)$', 'django.views.static.serve',{'document_root': '/path/to/media'}),

官方文檔中評價這種辦法：“The big, fat disclaimer”。

3.偽造404頁面：

使用正確的URL鏈接404頁面模板；

4.改變項目運行方式：

python manage.py runserver --insecure

最後這種是stackoverflow上最受歡迎的方法，確實簡單快捷！

以上為個人經驗，希望能給大傢一個參考，也希望大傢多多支持WalkonNet。如有錯誤或未考慮完全的地方，望不吝賜教。

推薦閱讀：