
本文详解如何通过 AJAX 将前端 JavaScript 计算的游戏分数(整数)异步提交到 Django 后端,并持久化存储到 Ranking 模型中,全程无需页面刷新,自动关联当前登录用户。
本文详解如何通过 ajax 将前端 javascript 计算的游戏分数(整数)异步提交到 django 后端,并持久化存储到 `ranking` 模型中,全程无需页面刷新,自动关联当前登录用户。
要将 JavaScript 游戏中的实时分数(如 score 变量)存入 Django 数据库,核心思路是:避免表单硬提交,改用 AJAX 异步 POST 请求,由后端视图接收、校验并创建 Ranking 实例。相比隐藏表单,AJAX 更灵活、可控性强,且能自然集成 CSRF 保护与用户身份识别。
✅ 步骤一:完善 Django 模型与视图
首先确保 Ranking 模型支持非空约束和时间记录(推荐增强实用性):
# models.py
from django.contrib.auth.models import User
from django.db import models
class Ranking(models.Model):
player = models.ForeignKey(User, on_delete=models.CASCADE, related_name='rankings')
game_overall_score = models.IntegerField()
created_at = models.DateTimeField(auto_now_add=True)
class Meta:
ordering = ['-game_overall_score', '-created_at']
接着,在 views.py 中新增一个专用 API 视图(推荐独立 URL,语义清晰),自动关联当前登录用户,无需前端传用户名:
# views.py
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.utils.decorators import method_decorator
from django.contrib.auth.decorators import login_required
import json
@login_required
def submit_score(request):
if request.method == 'POST':
try:
data = json.loads(request.body)
score = int(data.get('game_overall_score', 0))
# 自动绑定当前登录用户,无需前端提供 user ID 或 username
Ranking.objects.create(
player=request.user,
game_overall_score=score
)
return JsonResponse({'status': 'success', 'message': 'Score saved!'})
except (ValueError, json.JSONDecodeError, KeyError) as e:
return JsonResponse({'status': 'error', 'message': 'Invalid data'}, status=400)
return JsonResponse({'status': 'error', 'message': 'Only POST allowed'}, status=405)
并在 urls.py 中注册该路由(注意使用 login_required 保障权限):
# urls.py
from django.urls import path
from . import views
urlpatterns = [
path('games/<slug>/', views.loadGame, name='game_detail'),
path('api/submit-score/', views.submit_score, name='submit_score'),
]</slug>
✅ 步骤二:前端 JavaScript 提交逻辑(含 CSRF 保护)
在游戏模板(如 game-detail.html)中,移除隐藏表单,改用轻量级 AJAX 调用。关键点:
- 从 Django 模板注入 CSRF Token;
- 使用
fetch(现代推荐)或jQuery.ajax; - 错误处理与用户反馈。
<!-- 在模板底部或 <script> 块中 -->
<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script><script>
let score = 0;
// 示例:你的游戏逻辑(如每帧递增)
function updateScore() {
if (frameCount % 5 === 0) {
score++;
}
}
// 提交分数函数(可绑定到游戏结束事件)
function submitHighScore() {
const csrfToken = document.querySelector('[name=csrfmiddlewaretoken]').value;
fetch('{% url "submit_score" %}', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-CSRFToken': csrfToken // Django 要求的 CSRF 头
},
body: JSON.stringify({
'game_overall_score': score
})
})
.then(response => response.json())
.then(data => {
if (data.status === 'success') {
console.log('✅ Score submitted:', score);
alert('Your high score has been saved!');
} else {
throw new Error(data.message);
}
})
.catch(error => {
console.error('❌ Submission failed:', error);
alert('Failed to save score. Please try again.');
});
}
// 示例:游戏结束时调用(如碰撞检测触发)
// if (pipes[i].hits(bird)) {
// submitHighScore();
// }
</script>
⚠️ 重要注意事项
- 必须启用
django.middleware.csrf.CsrfViewMiddleware(默认已开启);- 前端
中的{% csrf_token %}会生成隐藏 input,需通过document.querySelector获取其值;- 不要将
@csrf_exempt用于此场景——它会破坏安全性;@login_required确保request.user始终有效,杜绝匿名提交;- 生产环境建议添加分数范围校验(如
0 )及重复提交防刷机制。
✅ 总结
你不需要隐藏表单,也不必手动管理用户字段。Django 的会话 + CSRF + 登录装饰器组合,配合简洁的 AJAX 请求,即可实现:
? 前端仅传一个整数 score;
? 后端自动绑定当前用户、写入数据库;
? 全程无跳转、有反馈、符合安全规范。
下一步可扩展:按游戏类型分类排行榜、添加 unique_together 防止同一用户多次提交相同游戏分数,或集成 WebSocket 实现实时榜单更新。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











