Media Finder上传图片后数据库未存路径，前端无法显示图片

这种问题在October CMS里挺常见的，咱们一步步排查解决：

1. 先检查fields.yaml的Media Finder配置是否正确 #

首先确保你的photo字段配置没有问题，因为你数据库里photo是字符串类型（存路径），配置需要明确指定类型和模式：

title:
    label: 标题
    type: text

photo:
    label: 图片
    type: mediafinder
    mode: image  # 上传图片用image，通用文件用file
    span: auto

重点是type: mediafinder和mode的设置——如果mode缺失或设置错误，可能导致路径无法正确写入数据库。

2. 确认模型的$fillable属性包含photo字段 #

这是最容易踩坑的点！October基于Laravel框架，默认启用批量赋值保护，只有在$fillable里列出的字段才会被允许写入数据库。打开你的模型文件（比如models/YourModel.php），检查是否有：

class YourModel extends Model
{
    // 必须把photo加到fillable数组里
    protected $fillable = ['title', 'photo'];

    // 其他模型逻辑...
}

如果photo不在$fillable里，哪怕你成功上传了图片，表单提交的值也不会被写入数据库。

3. 排查是否有自定义逻辑干扰保存 #

检查模型里有没有重写save()方法，或者添加了beforeSave这类事件钩子，不小心清空了photo字段。比如：

public function beforeSave()
{
    // 如果有类似这样的代码，会直接清空photo值
    // $this->photo = null;
}

如果存在这种逻辑，要么删除，要么调整成符合你需求的写法。

4. 验证请求数据是否正确传递 #

可以临时在模型的beforeSave里加一行代码，查看表单提交时photo的值是否正常传递：

public function beforeSave()
{
    dd(request()->all()); // 打印所有请求数据，检查photo字段是否有值
}

如果请求里能看到photo的路径，但数据库没存，那肯定是$fillable的问题；如果请求里没有photo值，那回去检查fields.yaml的配置，或者表单渲染是否异常。

5. 检查数据库字段长度 #

确保photo列的长度足够（比如设为varchar(255)或更长），如果图片路径太长超过了字段长度，数据库会截断数据，导致看起来像是没保存。

按照上面的步骤排查，大概率能解决问题——我遇到过的大部分情况都是$fillable没加photo导致的。

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