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

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。如有錯誤或未考慮完全的地方,望不吝賜教。