Django FileField字段值异常，外键关联访问文件路径结果不一致问题

问题根因 #

你遇到的异常行为核心是Map模型的data_file外键字段配置了to_field='file'，且DataFile模型未显式定义__str__方法：

• Django外键默认关联目标模型主键，显式指定关联FileField类型的file字段属于非常规用法，字段取值映射逻辑和默认逻辑不同
• shell环境下Django会全量加载模型字段的原始值，不会触发隐式转换，所以能拿到正确路径；实际运行时如果有隐式转字符串的操作，会调用模型默认的__str__方法返回title字段值，导致返回内容异常

解决方案 #

方案1：移除to_field配置（最推荐） #

直接删除Map外键的to_field参数，使用Django默认的主键关联逻辑，这是最稳定的用法：

class Map(models.Model): 
    # 其他字段省略
    data_file = models.ForeignKey(
        DataFile,
        on_delete=models.CASCADE,
        verbose_name = 'Файл данных'
    )

修改后执行迁移命令更新数据库：

python manage.py makemigrations
python manage.py migrate

迁移完成后即可通过obj.get().data_file.file.path稳定获取正确的文件路径。

方案2：保留to_field配置的兼容方案 #

如果业务逻辑必须保留to_field='file'的配置，不需要额外取.file属性，直接通过外键取值即可拿到文件对象：

# 直接获取文件路径
file_path = obj.get().data_file.path
# 直接获取文件对象
file_obj = obj.get().data_file

同时建议给DataFile显式定义__str__方法，避免隐式转换返回非预期内容：

class DataFile(models.Model):
    title = models.CharField(
        max_length=100,
        help_text='Краткое наименование данных',
        verbose_name = 'Наименование'
    )
    file = models.FileField(
        upload_to ='data/', 
        verbose_name = 'Файл данных',
        unique=True
    )

    def __str__(self):
        # 显式指定字符串返回值为文件路径
        return self.file.path

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