
本文详解如何通过 AJAX 将前端 JavaScript 计算的游戏分数(整数)异步提交至 Django 后端,并持久化到 Ranking 模型中,全程无需页面刷新,自动关联当前登录用户。
本文详解如何通过 ajax 将前端 javascript 计算的游戏分数(整数)异步提交至 django 后端,并持久化到 `ranking` 模型中,全程无需页面刷新,自动关联当前登录用户。
要将 JavaScript 游戏中实时计算的分数(如 score = 127)安全、可靠地存入 Django 的 Ranking 模型,不推荐使用隐藏表单 + 页面跳转式 POST——它会中断游戏体验、难以控制提交时机,且无法自动绑定登录用户(request.user)。更优解是采用 AJAX 异步提交 + Django 视图接收 JSON 数据 + 后端自动关联当前用户,既轻量又符合现代 Web 实践。
✅ 正确实现步骤
1. 前端:用 jQuery(或原生 Fetch)发送分数
确保已引入 jQuery(或改用 fetch),并在游戏结束/得分确定时触发提交:
<!-- 在 game-detail.html 模板底部添加 -->
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script>
let score = 0;
// 你的游戏逻辑(如帧计数加分)
if (frameCount % 5 === 0) {
score++;
}
// 游戏结束时调用此函数(例如点击“上传成绩”按钮或自动触发)
function submitScore() {
$.ajax({
url: "{% url 'save_score' game.slug %}", // 推荐使用命名 URL
type: "POST",
contentType: "application/json",
headers: {
"X-CSRFToken": "{{ csrf_token }}" // 关键:Django CSRF 安全要求
},
data: JSON.stringify({
"game_overall_score": score
}),
success: function(response) {
alert("✅ 成绩已上传!当前最高分:" + response.score);
},
error: function(xhr) {
console.error("提交失败:", xhr.responseJSON?.error || "网络错误");
alert("❌ 上传失败,请检查网络或重新登录");
}
});
}
</script>
<!-- 示例触发按钮(可替换为自动调用 submitScore()) -->
<button onclick="submitScore()">上传我的高分</button>? 提示:
score变量应定义在全局或闭包内确保可访问;实际项目中建议封装为模块化函数,避免污染全局作用域。
2. 后端:配置 URL 和视图处理逻辑
在 urls.py 中添加专用 API 路由(避免与 loadGame 混淆):
立即学习“Java免费学习笔记(深入)”;
# urls.py
from django.urls import path
from . import views
urlpatterns = [
path('games/<slug:slug>/', views.loadGame, name='game_detail'),
path('games/<slug:slug>/save-score/', views.save_score, name='save_score'), # 新增
]在 views.py 中编写专用视图,自动关联 request.user,验证登录状态,并保存到 Ranking:
# views.py
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.contrib.auth.decorators import login_required
from django.utils.decorators import method_decorator
import json
@login_required # 强制用户登录
def save_score(request, slug):
if request.method != 'POST':
return JsonResponse({'error': '仅支持 POST 请求'}, status=405)
try:
# 解析 JSON 数据
data = json.loads(request.body)
score_value = int(data.get('game_overall_score', 0))
# 获取对应游戏(可选校验,增强健壮性)
from .models import Game
game = Game.objects.get(slug=slug)
# 创建 Ranking 记录,自动绑定当前用户
ranking = Ranking.objects.create(
player=request.user,
game_overall_score=score_value
)
return JsonResponse({
'success': True,
'score': ranking.game_overall_score,
'player': ranking.player.username
})
except Game.DoesNotExist:
return JsonResponse({'error': '游戏不存在'}, status=404)
except ValueError:
return JsonResponse({'error': '分数必须为整数'}, status=400)
except Exception as e:
return JsonResponse({'error': '服务器内部错误'}, status=500)⚠️ 注意事项:
- 不要移除
@login_required:这是安全基石,确保只有登录用户才能提交成绩;- 保留
X-CSRFToken头:Django 默认启用 CSRF 防护,AJAX 必须携带该 token(模板中{{ csrf_token }}已提供);- 避免
@csrf_exempt:除非你有特殊理由,否则禁用 CSRF 会带来严重安全隐患;Ranking模型中player字段已设为ForeignKey(User),因此request.user可直接赋值。
3. 可选增强:前端防重复提交 & 用户反馈
let isSubmitting = false;
function submitScore() {
if (isSubmitting) return;
isSubmitting = true;
// ... AJAX 调用 ...
// 成功/失败后重置状态
.always(() => { isSubmitting = false; });
}✅ 总结
- 核心原则:用 AJAX 替代表单提交,实现无刷新、高响应、易控制;
-
安全关键:始终校验用户登录状态(
@login_required)、传递 CSRF Token、服务端类型校验; -
数据归属:Django 后端自动通过
request.user绑定玩家,无需前端传用户名或 ID; - 扩展友好:后续可轻松添加时间戳、游戏难度、设备信息等字段,只需同步模型与视图即可。
这套方案简洁、安全、可维护,完美适配单分数提交场景,是 Django 游戏积分系统落地的标准实践。



















