問題現象:在 Django 專案裡用 jQuery 發 Ajax POST,請求會被擋下來並回傳 403。
原因幾乎一定是 CSRF 保護。以下兩個方法都能解決,第一個是官方推薦做法,第二個則是取捨之後的緊急手段。
Django 官方文件裡就附了一段現成的程式碼。把它存成一個獨立的 js 檔,在頁面中引入即可——但要注意順序:必須排在 jQuery 之後,否則 $ 尚未定義就會出錯。
$(document).ajaxSend(function(event, xhr, settings) {
function getCookie(name) {
var cookieValue = null;
if (document.cookie && document.cookie != '') {
var cookies = document.cookie.split(';');
for (var i = 0; i < cookies.length; i++) {
var cookie = jQuery.trim(cookies[i]);
// 這個 cookie 的名稱是否就是我們要的?
if (cookie.substring(0, name.length + 1) == (name + '=')) {
cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
break;
}
}
}
return cookieValue;
}
function sameOrigin(url) {
// url 可能是相對路徑、protocol-relative 或絕對路徑
var host = document.location.host; // host + port
var protocol = document.location.protocol;
var sr_origin = '//' + host;
var origin = protocol + sr_origin;
// 允許同源的絕對路徑與 protocol-relative 路徑
return (url == origin || url.slice(0, origin.length + 1) == origin + '/') ||
(url == sr_origin || url.slice(0, sr_origin.length + 1) == sr_origin + '/') ||
// 或者根本不是 protocol-relative / 絕對路徑,也就是相對路徑
!(/^(\/\/|http:|https:).*/.test(url));
}
function safeMethod(method) {
return (/^(GET|HEAD|OPTIONS|TRACE)$/.test(method));
}
if (!safeMethod(settings.type) && sameOrigin(settings.url)) {
xhr.setRequestHeader("X-CSRFToken", getCookie('csrftoken'));
}
});
它的運作邏輯很乾淨:攔下每一次 ajaxSend,判斷這個請求不是安全方法(GET/HEAD/OPTIONS/TRACE)、且目標同源自家網域,才把 cookie 裡的 csrftoken 塞進 X-CSRFToken 標頭。跨域請求不會被附帶 token,安全性沒有被削弱。
直接在處理 POST 的 view 前加上裝飾器:
@csrf_exempt
def profile_delte(request):
del_file = request.POST.get("delete_file", '')
...
這招確實有效,但等於對這條路徑關掉了 CSRF 防護。如果該 view 會被外部跨站呼叫、又牽涉到刪除這類破壞性操作,風險不小。我的建議是:只有在確認這個端點確實需要對外開放(例如給機器對機器呼叫的 API),才用這個方法,並搭配其他驗證機制補強。
如果你用的是 Django REST Framework,除了在 settings 裡調整 DefaultAuthentication 的 SessionAuthentication,也可以在視圖上明確標註權限類別;若改用 Token 或 JWT 認證,CSRF 檢查本身就不會被觸發,因為那類認證不依賴 cookie。
解法當然不只這兩種,歡迎分享你在實務上遇到的處理方式。