Laravel 5.4 API开发：如何将字段默认值设为空而非null

针对你遇到的问题——大量API需要将Null值转换为对应类型的默认值（空字符串、0等），这里有几个高效且可扩展的解决方案，不用逐个API或字段处理：

1. 基于基类模型的全局属性转换（最精准） #

创建一个所有API模型继承的基类，在基类中重写属性获取或数组转换方法，根据数据库字段类型自动替换Null值。这种方式能精准匹配字段类型，且一次配置全局生效。

方案A：重写toArray()方法（仅影响API响应） #

这个方法只在模型转为数组（API返回JSON的必经步骤）时生效，不会影响业务代码中对模型属性的使用：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class BaseApiModel extends Model
{
    public function toArray()
    {
        $attributes = parent::toArray();
        
        foreach ($attributes as $key => $value) {
            if (is_null($value)) {
                // 优先使用模型中定义的$casts类型，没有则查询数据库字段类型
                $castType = $this->getCasts()[$key] ?? null;
                if (!$castType) {
                    $column = $this->getConnection()->getDoctrineColumn($this->getTable(), $key);
                    $castType = $column->getType()->getName();
                }

                // 根据类型设置默认值
                switch ($castType) {
                    case 'string':
                    case 'text':
                    case 'date':
                    case 'datetime':
                        $attributes[$key] = '';
                        break;
                    case 'integer':
                    case 'bigint':
                    case 'smallint':
                    case 'float':
                    case 'double':
                        $attributes[$key] = 0;
                        break;
                    case 'boolean':
                        $attributes[$key] = false;
                        break;
                    default:
                        $attributes[$key] = '';
                }
            }
        }

        return $attributes;
    }
}

之后让你的API模型都继承这个BaseApiModel：

class User extends BaseApiModel
{
    // 模型原有代码...
}

方案B：重写getAttribute()方法（全局属性访问生效） #

如果希望业务代码中访问模型属性时也自动替换Null值，可以重写这个方法：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class BaseApiModel extends Model
{
    public function getAttribute($key)
    {
        $value = parent::getAttribute($key);
        
        if (is_null($value) && !in_array($key, $this->getDates())) {
            $castType = $this->getCasts()[$key] ?? $this->getConnection()->getDoctrineColumn($this->getTable(), $key)->getType()->getName();
            
            switch ($castType) {
                case 'string':
                case 'text':
                    return '';
                case 'integer':
                case 'bigint':
                case 'smallint':
                    return 0;
                case 'boolean':
                    return false;
                default:
                    return '';
            }
        }

        return $value;
    }
}

2. 全局响应中间件（无需修改模型） #

如果不想改动模型，可以创建一个中间件，在API响应发送前统一处理所有Null值。这种方式的缺点是无法精准判断字段类型，适合快速实现通用转换：

步骤1：创建中间件 #

php artisan make:middleware TransformNullValues

步骤2：编写中间件逻辑 #

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\JsonResponse;

class TransformNullValues
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);
        
        // 只处理JSON响应
        if ($response instanceof JsonResponse) {
            $data = $response->getData(true);
            $transformed = $this->replaceNulls($data);
            $response->setData($transformed);
        }
        
        return $response;
    }

    private function replaceNulls($data)
    {
        if (is_array($data)) {
            foreach ($data as $key => $value) {
                $data[$key] = $this->replaceNulls($value);
            }
        } elseif (is_object($data)) {
            foreach ($data as $key => $value) {
                $data->$key = $this->replaceNulls($value);
            }
        } elseif (is_null($data)) {
            // 这里可以根据需求调整，比如默认转空字符串，或对数值转0
            return '';
        }
        
        return $data;
    }
}

步骤3：注册中间件 #

在app/Http/Kernel.php的API中间件组中添加：

protected $middlewareGroups = [
    'api' => [
        'throttle:60,1',
        'bindings',
        \App\Http\Middleware\TransformNullValues::class,
    ],
];

3. 数据库层面彻底解决（结合代码方案更稳妥） #

你提到phpMyAdmin无法设置默认值为空，其实MySQL支持为不同类型字段设置合理默认值：

• 字符串/文本类型：设置默认值为''（空字符串）
• 整数/浮点类型：设置默认值为0
• 布尔类型：设置默认值为0（false）

同时，批量更新已有数据中的Null值：

-- 处理字符串字段
UPDATE your_table SET string_column = '' WHERE string_column IS NULL;

-- 处理数字字段
UPDATE your_table SET int_column = 0 WHERE int_column IS NULL;

这个方案能从源头减少Null值的产生，再结合代码层面的转换，就能彻底解决问题。

方案选择建议 #

• 追求精准性：优先选择**基类模型重写toArray()**的方案，既能精准匹配字段类型，又不影响业务代码。
• 快速实现：如果字段类型差异不大，全局响应中间件是最快的方式。
• 彻底解决：结合数据库默认值+批量更新+代码转换，从源头到输出全流程覆盖。

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