在 Django 專案裡用 jQuery 發 Ajax POST,十個人有九個會撞到同一堵牆:伺服器回 403。這不是你的程式寫錯了,而是 Django 的 CSRF 中介軟體在正常運作。
Django 預設啟用 CsrfViewMiddleware,凡是會改變狀態的請求(POST、PUT、PATCH、DELETE)都必須帶上一個有效的 CSRF token,用來確認這個請求確實是從你自己的頁面發出的,而不是別的網站誘導使用者偷偷提交的。Ajax 請求預設不會自動附上這個 token,於是中介軟體直接擋下。
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 = ; i < cookies.length; i++) { var cookie = jQuery.trim(cookies[i]); if (cookie.substring(, name.length + ) == (name + '=')) { cookieValue = decodeURIComponent(cookie.substring(name.length + )); break; } } } return cookieValue; } function sameOrigin(url) { // url 可能是相對路徑、schemeless 或完整絕對路徑 var host = document.location.host; var protocol = document.location.protocol; var sr_origin = '//' + host; var origin = protocol + sr_origin; return (url == origin || url.slice(, origin.length + ) == origin + '/') || (url == sr_origin || url.slice(, sr_origin.length + ) == sr_origin + '/') || !(/^(\/\/|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')); } });
這段程式做了三件事:從 cookie 讀出 csrftoken、確認請求是同源、確認請求方法不是安全方法(GET/HEAD/OPTIONS/TRACE),三個條件都成立時才把 token 塞進 X-CSRFToken 標頭。它的好處是全域生效,你不必在每一個 $.ajax() 呼叫處手動加參數。
另外提醒,如果表單是標準的 HTML 表單,也可以在模板裡直接放:
<input type="hidden" name="csrfmiddlewaretoken" value="{{ csrf_token }}">
並確認 {{ csrf_token }} 有被渲染進去——很多人是漏了 {% csrf_token %} 或 cookie 沒設定才出問題。
@csrf_exempt def profile_delte(request): del_file=request.POST.get("delete_file",'')
加上這個裝飾器後,該 view 就不再檢查 CSRF token。
方法二很有效,也很危險。@csrf_exempt 等於對那個端點關掉防護,而 CSRF 攻擊的原理正是「假借使用者已登入的身分,從別的網站對你的端點送出請求」。看看上面那個 view 在做什麼——刪檔案。這正是最不該被豁免的操作類型。
因此合理的取捨是:
@csrf_exempt 才是安全的——因為 CSRF 攻擊的前提是瀏覽器會自動帶上憑證,而自訂標頭裡的 token 不會被第三方網站帶著走。