Django首页访问触发ValueError：需传入User实例而非'instructor'

1. 确认自定义User模型的全局配置 #

由于你使用了自定义User模型，必须在项目settings.py中指定AUTH_USER_MODEL，否则Django会默认使用内置的auth.User，导致外键关联类型不匹配：

# settings.py
AUTH_USER_MODEL = '你的应用名.User'  # 替换为models.py所在的应用名称，比如'base.User'

2. 检查视图中User的导入正确性 #

确保views.py中导入的User是你自定义的模型，而非Django内置的：

# views.py 顶部的导入语句
from .models import User  # 正确：导入自定义User
# 避免使用：from django.contrib.auth.models import User

3. 排查模板中的错误代码（最可能的原因） #

错误信息显示尝试查询字符串"instructor"，但需要User实例，大概率是homepage.html模板中存在错误逻辑：

• 错误示例：将字符串与User实例直接比较或查询

  {% if course.instructor == 'instructor' %}  <!-- 错误：字符串与User实例类型不匹配 -->
  

• 正确写法：如果你要判断该用户是否是讲师（自定义User的instructor布尔字段），应写：

  {% if course.instructor.instructor %}  <!-- 正确：访问User实例的instructor布尔属性 -->
  

同时检查模板中所有涉及instructor的查询语句，比如是否有courses.filter(instructor='instructor')这类错误写法，这类代码会将字符串传入查询，触发类型错误。

4. 确认Enrollment模型的正确性 #

确保Enrollment模型的student字段关联的是自定义User模型：

# models.py
class Enrollment(models.Model):
    student = models.ForeignKey(User, on_delete=models.CASCADE)
    course = models.ForeignKey(Course, on_delete=models.CASCADE)
    enrolled_at = models.DateTimeField(auto_now_add=True)  # 可选字段

完成以上检查后，重启Django服务并重新访问首页，问题即可解决。

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