EOS Low-Code Platform 8
学习指南
更新说明
初见EOS
专业代码开发手册
公共服务框架
最佳实践
运维指南

# 视图导入导出问题排查指南

# 一、前置操作：补丁更新

在开始排查问题前，请务必完成以下补丁更新步骤，以排除已知问题的干扰：

前端： 优先安装最新的前端补丁。

后端： 优先建议安装后端合集补丁，若无合集补丁通过以下链接检查是否存在相关补丁。若存在，请先安装对应补丁再进行后续问题排查。

补丁参考链接：http://help.primeton.com/productcs/patches/

# 二、通用排查流程

# （一）重要前提：字段变动后的维护

在进行任何问题排查前，请先确认是否存在以下情况，这是许多导入 / 导出异常的常见原因：

  • 导入按钮维护：若导入按钮已配置完成，但后续对表单字段进行了组件类型变动或字段本身的调整，则需要在导入按钮的 “转码配置” 中，刷新字段映射关系，或直接删除并重新添加导入按钮。
  • 导出按钮维护：若导出按钮已配置完成，但后续对视图中的字段名称进行了修改，则需要在导出按钮的 “导出字段配置” 中，对相关字段进行重置，或直接删除并重新添加导出按钮。

# （二）问题排查步骤

如果已完成上述维护操作问题仍存在，请按以下步骤进行排查：

  1. 确认现象：详细记录并确认具体的错误提示信息、页面的异常表现或功能的失效行为。

  2. 前端分析（F12）

    ：打开浏览器开发者工具（F12），切换到 “网络” 和 “控制台” 面板：

    • 在 “网络” 面板中，执行导出 / 导入操作，检查对应的接口请求参数、响应状态码及返回数据是否正常。
    • 在 “控制台” 面板中，查看是否有 JavaScript 报错或其他异常信息。

  3. 后端日志分析：结合前端 F12 的分析结果，重点查看应用服务器的日志文件 应用/logs/eos-trace.log，根据日志中的具体报错堆栈信息进行深入的问题定位和原因分析。

# 三、导入相关问题排查与解决方案

# （一）日期字段处理问题

# 1. 日期格式解析失败

  • 问题现象：Excel中的日期格式为“1900/1/1”或其他非标准格式，导入时系统提示“日期解析失败”或类似错误。

  • 排查步骤：

    1. 检查Excel文件中日期列的单元格格式。
    2. 确认导入模板或系统是否要求特定的日期格式（如“yyyy-mm-dd”）。

  • 解决方案：

    1. 将Excel文件中对应的日期列的单元格格式设置为“文本”格式。
    2. 手动将所有日期修改为系统支持的统一格式，例如“yyyy-mm-dd”。

# 2. 时分秒信息丢失

  • 问题现象：导入后，数据库中对应的日期字段仅存储了“年月日”，而“时分秒”信息丢失。

  • 排查步骤：

    1. 检查数据库表结构，确认该日期字段的数据类型是DATE还是DATETIME/TIMESTAMP。
    2. 确认导入的Excel文件中是否包含了“时分秒”信息。

  • 解决方案：若需要保留时间信息，需将数据库中对应字段的类型修改为DATETIME或TIMESTAMP类型。

# 四、导出相关问题排查与解决方案

# （一）权限不足问题

  • 问题现象：执行导出操作时，系统提示“没有执行方法的权限，方法名 'exportView'， 可能需要授权功能码'app developer or manager role'”。

  • 解决方案：在开发中心的“配置管理”模块中进行授权。

# （二）数据导出超时问题

  • 问题现象：导出操作长时间无响应，最终提示超时错误。

  • 排查步骤：

    1. 检查待导出数据量是否过大，或查询条件是否过于复杂。
    2. 确认网络连接是否稳定。
    3. 查看Nginx服务器的超时配置参数。

  • 解决方案：调整Nginx服务器的超时时间配置。在Nginx配置文件中，找到对应的location块，增加或修改以下参数：

    proxy_connect_timeout 600s;
proxy_read_timeout 600s;

    修改后需重启Nginx服务。

# （三）导出文件为0KB问题

# 1. Java内存溢出

  • 问题现象：大数据导出失败，后台日志报错 Java heap space。

  • 排查步骤：

    1. 查看应用服务器日志文件，确认是否存在OutOfMemoryError。
    2. 评估待导出数据量大小，判断是否超出当前JVM内存限制。

  • 解决方案：调整应用服务器的JVM启动参数，增加堆内存分配。

    -Xms1024m -Xmx4096m

    修改后需重启应用服务器。

# 2. 业务字典重复

  • 问题现象：导出文件0KB，后台日志报错 Duplicate key <DictType>。

  • 排查步骤：

    1. 根据日志中的<DictType>，定位到具体的业务字典。
    2. 检查该字典下是否存在code值重复的字典项。

  • 解决方案：进入数据字典管理界面，清理或修改重复的字典项，确保每个字典的code值唯一。

# （四）导出范围异常问题

  • 问题现象：在列表页选择“导出当前页数据”，但实际导出了符合查询条件的全部数据。
  • 排查步骤：
    1. 检查实体配置：若当前使用的是查询实体，请确认该实体是否已正确配置主键字段。
    2. 检查接口传参：打开F12，执行导出操作，找到导出接口，查看请求参数
    3. 定位问题根源：若参数传递异常，说明是前端或接口逻辑问题；若参数正确，则可能是后端处理逻辑问题。
  • 解决方案：
    • 若为实体配置问题，补充或修正查询实体的主键配置。
    • 若为接口传参或后端逻辑问题，请通过ame+发起工单系统提交问题（提供相关日志文件）。

← 弹窗相关问题排查指南 →