request.build_absolute_uri()用法

request.build_absolute_uri() 是 Django 中一个非常实用的方法，用于构建完整的、绝对的 URL（包含协议、域名、端口和路径）。

---

📌 基本语法

request.build_absolute_uri(location=None)

• 如果 不传参数：返回当前请求的完整绝对 URL。
• 如果 传入 location（字符串） ：将 location 拼接到当前站点的根地址上，生成完整 URL。

---

✅ 举个例子

假设你的网站部署在：

https://example.com:8000/myapp/

情况 1：不传参数（获取当前页面完整 URL）

# 用户访问 https://example.com:8000/student/123/
full_url = request.build_absolute_uri()
print(full_url)
# 输出: https://example.com:8000/student/123/

情况 2：传入相对路径（常用于生成二维码、分享链接等）

relative_path = "/student-volunteer-er/6/"
full_url = request.build_absolute_uri(relative_path)
print(full_url)
# 输出: https://example.com:8000/student-volunteer-er/6/

💡 即使你本地开发用 http://127.0.0.1:8000，它也会自动适配为 http://127.0.0.1:8000/...

部署到线上后自动变成 https://yourdomain.com/...，无需硬编码域名！

---

🔧 常见用途

场景	说明
生成二维码	二维码必须是完整 URL，不能是 /path/
发送邮件中的链接	邮件里不能用相对路径，必须是 https://...
第三方回调地址	如微信登录、支付回调，需要提供完整 URL
SEO 或 Open Graph 标签	<meta property="og:url" content="完整URL">

---

⚠️ 注意事项

1. 依赖 Host 请求头

   Django 通过 request.get_host() 获取域名，而 get_host() 来自 HTTP 请求头中的 Host 字段。

   → 所以在反向代理（如 Nginx）后面时，要确保正确传递 Host 头，或设置 USE_X_FORWARDED_HOST = True。

2. 不要手动拼接 http:// + domain + path

   这样容易出错（比如忘记端口、协议是 http/https 混乱）。

   ✅ 用 build_absolute_uri() 更安全、更通用。

3. 与 reverse() 配合使用

   from django.urls import reverse
   
   relative_url = reverse('student_volunteer_erlist', kwargs={'student_id': 6})
   absolute_url = request.build_absolute_uri(relative_url)
   # 结果: https://example.com/student-volunteer-er/6/

---

✅ 总结

方法	返回值
request.path	/student/123/（仅路径）
request.get_full_path()	/student/123/?a=1（路径+查询参数）
request.build_absolute_uri()	https://example.com/student/123/（完整 URL）✅