FLEMM_R2报表调度异常：本地正常，服务器端调度生成不稳定

问题概述 #

• 报表FLEMM_R2存在间歇性生成失败问题
• 本地环境生成完全正常，服务器/调度环境下结果不稳定
• 已确认配置信息无误，配置详情如下：

{
    "reportDetails": {
        "reportIcon": "https://s3-ap-southeast-1.amazonaws.com/faclonpics/organisation/faclon.png",
        "reportId": "FLEMM_R2",
        "subHeader1": "Consumption",
        "subHeader2": "jujuujujujujuju",
        "reportName": "FLEMM_R2",
        "title": "FLEMM_R2",
        "timezone": "Asia/Calcutta",
        "extension": "xlsx",
        "cycleTime": "00:00",
        "reportDuration": "currentMonth",
        "reportPeriodicity": "monthly",
        "devConfig": [
            {
                "devID": "INEM_DEMO_90",
                "sensorID": "VOLTS1"
            },
            {
                "devID": "INEM_DEMO_91",
                "sensorID": "VOLTS1"
            }
        ],
        "devConfigFormat": [
            {
                "devices": [
                    "INEM_DEMO_90",
                    "INEM_DEMO_91"
                ],
                "devicesName": [
                    "INEM_DEMO_90",
                    "INEM_DEMO_91"
                ],
                "sensor": "VOLTS1",
                "sensorName": "Voltage 1"
            }
        ],
        "clusters": [],
        "clusterUnit": {}
    },
    "extension": "xlsx",
    "repeat": "1",
    "invocationTime": "19:01",
    "invocationDays": [
        5
    ],
    "startTime": "18:58",
    "endTime": "18:58",
    "interval": "1",
    "selectedContacts": [
        {
            "_id": "62bbfdd1c64a2f5ce72d4fe9",
            "name": "Nikhil Srivastava",
            "mobiles": [],
            "emails": [
                "nikhil.faclon@gmail.com"
            ]
        }
    ],
    "scheduleName": "jujuujujujujuju"
}

排查方向及解决方法 #

1. 服务器资源限制

• 监控报表生成时段的CPU、内存、磁盘IO使用率：服务器资源紧张时，报表生成任务可能被系统抢占或超时，本地环境资源充足所以无此问题。可通过top、iostat命令或监控工具查看指标。
• 若资源不足，调整调度时间避开业务高峰，或升级服务器配置。

2. 数据源访问稳定性

• 检查服务器环境下设备数据（INEM_DEMO_90/91的VOLTS1传感器）的获取是否稳定：本地可能有缓存或直接连接数据源，服务器可能存在网络波动、数据源接口限流或超时。
• 查看数据获取阶段的日志，确认是否存在连接超时、数据为空或接口报错，添加重试机制或延长超时时间。

3. 时区与时间配置冲突

• 验证调度系统时区是否与报表配置的Asia/Calcutta一致：服务器时区不匹配会导致任务触发时间异常，进而影响数据范围的正确获取。
• 核对调度任务的实际触发时间戳，确认与配置的invocationTime一致。

4. 文件存储权限与路径

• 检查服务器上报表生成目录的读写权限：本地环境权限宽松，服务器可能因权限不足、磁盘满等问题导致文件无法写入，表现为间歇性失败。
• 确保调度进程对存储目录有读写权限，定期清理磁盘空间。

5. 调度服务自身稳定性

• 检查调度服务（如Cron、Airflow等）的日志：确认任务每次都被正确触发，无进程崩溃、任务丢失或重复执行的情况。
• 若调度服务存在异常，重启服务或修复配置。

6. 依赖库版本差异

• 对比本地与服务器环境的报表生成依赖库（如Excel处理库）版本：版本不兼容可能导致特定场景下代码执行失败。
• 统一依赖库版本后重新测试。

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