Django用户个人页显示异常：URL正确但渲染基础模板

1. 修复URL名称配置（解决{% url %}标签报错） #

首先确保你的URL配置中给个人页路径设置了正确的name属性，这是模板标签能找到对应视图的关键：

# 项目或app的urls.py
from django.urls import path
from . import views

urlpatterns = [
    # 其他路由...
    path('user_profile/<int:user_id>/', views.user_profile_view, name='user_profile'),
]

之后在模板中就可以正常使用{% url 'user_profile' user.id %}生成URL，无需硬编码。

2. 检查视图函数的模板渲染逻辑 #

确保视图函数正确返回user_profile.html模板，而非仅返回base.html：

# views.py
from django.shortcuts import render, get_object_or_404
from django.contrib.auth.models import User

def user_profile_view(request, user_id):
    # 获取目标用户（如果有自定义Profile模型，替换为对应的查询）
    target_user = get_object_or_404(User, id=user_id)
    # 传递上下文到模板，确保渲染正确的内容
    return render(request, 'user_profile.html', {'user': target_user})

如果使用类视图（如DetailView），需指定正确的template_name：

# views.py
from django.views.generic import DetailView
from django.contrib.auth.models import User

class UserProfileView(DetailView):
    model = User
    template_name = 'user_profile.html'  # 必须指定目标模板
    context_object_name = 'user'

3. 修正模板继承与块填充 #

user_profile.html必须正确继承base.html并填充对应的内容块，否则只会显示base.html的默认内容：

<!-- user_profile.html -->
{% extends 'base.html' %}

<!-- 确保block名称与base.html中定义的一致，比如base.html里用的是{% block content %} -->
{% block content %}
    <h2>{{ user.username }}的个人主页</h2>
    <!-- 个人页具体内容，比如头像、简介等 -->
    <img src="{{ user.profile.avatar.url }}" alt="用户头像">
    <p>{{ user.profile.bio }}</p>
{% endblock %}

如果base.html中没有定义对应的block，或者子模板没有使用正确的block名称，就会只渲染base.html的原始内容。

4. 验证模板加载路径 #

检查settings.py中的模板配置，确保你的app已添加到INSTALLED_APPS，并且模板引擎开启了APP_DIRS：

# settings.py
INSTALLED_APPS = [
    # 内置app...
    'your_app_name',  # 你的app名称
]

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],  # 如果模板放在项目根目录的templates，这里需添加路径
        'APP_DIRS': True,  # 开启后Django会自动搜索app下的templates目录
        # 其他配置...
    },
]

确保user_profile.html放在your_app/templates/目录下，Django才能正确找到它。

内容的提问来源于stack exchange，提问作者user15020654