Laravel Nova 用Model而非Resource时Trend指标空显示问题

问题描述 #

已编写如下按天统计用户交互量的Nova Trend指标代码：

<?php

namespace App\Nova\Metrics;

use App\Models\UserInteraction;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Metrics\Trend;

class InteractionsPerDay extends Trend
{
    /**
     * 计算指标值
     *
     * @param  \Laravel\Nova\Http\Requests\NovaRequest  $request
     * @return mixed
     */
    public function calculate(NovaRequest $request)
    {
        return $this->countByDays($request, UserInteraction::class);
    }

    /**
     * 配置指标可选时间范围
     *
     * @return array
     */
    public function ranges()
    {
        return [
            30 => '30天',
            60 => '60天',
            90 => '90天',
        ];
    }

    /**
     * 配置指标结果缓存时长
     *
     * @return \DateTimeInterface|\DateInterval|float|int|null
     */
    public function cacheFor()
    {
        // return now()->addMinutes(5);
    }

    /**
     * 获取指标URI标识
     *
     * @return string
     */
    public function uriKey()
    {
        return 'interactions-per-day';
    }
}

数据库中UserInteraction模型已存在对应统计数据，且已排除Policy授权策略拦截的权限因素，实际页面中趋势区域完全为空，异常效果如下：

可能诱因及解决方案 #

• 时间字段配置不匹配
  Nova内置countByDays方法默认使用模型的created_at字段作为时间统计维度，如果UserInteraction模型自定义了CREATED_AT常量、实际用于统计的时间字段不是created_at，或是created_at字段存在值为NULL、格式非法、时间全部超出所选统计范围（如数据均为100天前生成，当前选中30天统计范围）的情况，都会导致查询结果为空。
  解决方案：调用countByDays时传入第三个参数指定正确的统计时间字段，示例：

  return $this->countByDays($request, UserInteraction::class, 'interaction_time');
  

• 模型全局作用域过滤数据
  即使未配置Policy授权，若UserInteraction模型挂载了全局作用域（如多租户数据隔离、软删除、自定义数据权限过滤的Scope），指标查询时会自动追加对应过滤条件，导致查询结果为空。
  解决方案：指标查询时按需移除全局作用域，示例：

  // 移除所有全局作用域
  return $this->countByDays($request, UserInteraction::withoutGlobalScopes());
  // 软删除场景需包含已删除数据时
  return $this->countByDays($request, UserInteraction::withTrashed());
  

• 时区配置不一致
  应用时区、数据库时区配置不匹配时，Nova生成的时间查询范围与数据库存储的时间会出现偏移，导致选中时间范围内匹配不到数据。
  解决方案：检查config/app.php的timezone配置与数据库连接的时区配置，确保两者统一，国内环境可统一设置为Asia/Shanghai。
• 指标注册逻辑异常
  若指标类未在对应Nova资源的cards()方法、或仪表盘的cards()方法中正确实例化返回，会出现前端加载卡片框架但无数据的问题。
  解决方案：检查对应注册位置的代码，确保正确返回new InteractionsPerDay()实例，无多余条件判断拦截指标返回。
• 前端资源缓存异常
  Nova版本升级、自定义Nova组件开发后，旧的前端缓存可能导致趋势图渲染逻辑异常。
  解决方案：执行以下命令重新发布Nova资源、清理应用缓存：

  php artisan nova:publish
  php artisan config:clear
  php artisan cache:clear
  

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