故障排除和常见问题解答

常见问题解答（FAQ）

Q：我的注册码已过期，应该怎么处理？

A：在软件界面中，通过点击右上角设置键，选择“关于”选项，用户可以查看注册码的激活状态、创建时间以及到期时间。若需添加新的注册码，用户需截图或拍照当前界面（包含 Machine Name 即可），并将其发送给畅链科技客服。客服人员将为用户提供新的注册码，用户只需将该注册码添加至系统即可完成软件激活（在此过程中，系统将对注册码的格式、内容以及有效期进行校验，确保激活的准确性和有效性）。

Q：如何强行停止服务（服务异常如何解决）？

A：Ctrl + Alt + Delete 打开任务管理器，进入详细信息后就可以看到多个 Java.exe，每个 Java.exe 对应一个服务,查看想要停止的服务对应的路径，右键结束任务即可强行停止服务。

Q：畅链科技 EDI 是否有网页版可以进行定制化注册服务？

A：有！用户无需深入了解编辑流程及其运行方式，只需专注于关键实际操作，如查看库存、打印标签以及下载相应的 PDF 文件等操作。畅链数据集成平台 (CLIP) 的实施可由我们专业的实施人员负责，为用户提供直观而高效的服务。

Q：如何具体的设置邮件组件的SMTP、端口等信息？

A：以飞书邮箱举例，只需要在邮件设置里点击第三方邮箱客户端登录，选择设备类型后就可以生成 SMTP 服务器、端口以及专用密码等信息（下图选择的是 windows 电脑）。

Q：畅链数据集成平台应该如何生成证书？

A：先登录畅链数据基础平台，点击服务，在右侧选择相应的服务，这里以生成AS2证书为例，选择AS2，在证书一栏点击钥匙图标即可生成证书，填写名称、别名、文件名、密码、有效期、密钥大小、算法等信息之后点击保存即可生成证书。

Q：我在部署畅链数据集成平台的时候为什么会出现“无法启动此程序，因为计算机中丢失VCRUNTIME140.dll”的错误呢？

A: 如果出现“无法启动此程序，因为计算机中丢失VCRUNTIME140.dll”的错误信息，可能是由于与 Visual C++ 相关的DLL文件丢失或损坏所引起，因此，您可以尝试重新安装Microsoft Visual C++ 2015 Redistributable或 Microsoft Visual C++ 2015-2019 Redistributable以解决问题。

下载地址

Microsoft Visual C++ 2015-2019 Redistributable - 14.26.28720.3（适用Windows 7以上）
x86：VC_redist.x86.exe
x64：VC_redist.x64.exe
ARM64：VC_redist.arm64.exe

Microsoft Visual C++ 2015 Redistributable – 14.0.24516.0（适用Windows XP）
x86：vc_redist.x86.exe
x64：vc_redist.x64.exe

**提示：**Visual C++ 2015, 2017, 2019 所有版本现在共用一个安装包。

例如，安装 Visual C++ 2019 Redistributable将影响使用 Visual C++ 2015, 2017 构建的程序。但是，安装 Visual C++ 2015 不会取代 Visual C++ 2017, 2019 安装的文件的较新版本。

这与所有以前 Visual C++ 版本不同，因为它们各自都有自己独有的运行库文件，而不是与其它版本共享。

Q：我在部署畅链数据集成平台的时候执行bat文件出现乱码应该如何解决？

A: 默认情况下，若在 bat 文件中出现中文字符，运行时则会出现乱码情况，若要避免运行时乱码，需要修改文本编码！
解决方法：选中需要修改的文件，点击鼠标右键，选择“编辑”进入文件编辑页面后，点击“文件”，选择“另存为”在另存为时选择“ ANSI”编辑保存，再次运行bat脚本即可！

Q：我在部署畅链数据集成平台的时候出现”cmd无法打开服务管理器“应该如何解决？

A: 以管理员身份运行cmd.exe，再次执行此bat脚本即可。

Q：出现下面问题怎么办

sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

A: 按顺序检查下面问题。

1. 证书是否存在。
2. 证书是否过期。
3. 域名和证书域名是否匹配。
4. 根证书是否在证书库中。

Q：提示证书找不到

A:

1. 根证书/中间证书未在对方信任库中。
2. 证书过期。
3. Common Name/SAN 与 URL 域名不匹配。

• Common Name： 证书主题中的 CN 字段。
• Subject Alternative Name： 现代证书更依赖 SAN 扩展字段，它可以包含多个域名、IP地址等。
• 验证规则： 客户端（发起连接的一方）会检查它正在连接的 URL 中的主机名 是否与服务器证书中的 CN 或 SAN 列表中的任何一个条目精确匹配（不区分大小写）

4. 其他可能原因：

• 证书链不完整 (发送端问题)
• 信任库配置错误
• 密钥库配置错误 (身份证书问题)
• 协议或端口问题 (误报)
• 证书吊销

Q：PGSQL安装脚本执行，提示权限不足

问题现象：

PGSQL安装脚本执行，提示权限不足 “initdb: 错误: 无法改变目录 "C:/xxx/install/db" 的权限: Permission denied”.

A:

1. 删除 db 目录，重新执行初始化脚本，自动创建 db 目录。

Q: 登录界面，验证码加载不出来

问题现象：

登录界面，验证码加载不出来。显示 404 图标。

A:

1. 系统中安装字体库，一般在Linux环境中出现。

解决方案：

安装字体库。

• 在 CentOS 上安装必要的字体包

# 安装字体配置工具
yum install -y fontconfig

# 安装 DejaVu 字体
yum install -y dejavu-sans-fonts
yum install -y dejavu-sans-mono-fonts
yum install -y dejavu-serif-fonts

# 刷新字体缓存
fc-cache -fv

# 检查字体是否安装成功
fc-list

• 在 Ubuntu/Debian 上安装必要的字体包

# 安装字体配置工具
sudo apt-get install -y fontconfig

# 安装 DejaVu 字体（开源字体，替代 Arial/Helvetica）
sudo apt-get install -y fonts-dejavu-core
sudo apt-get install -y fonts-dejavu-extra

# 安装常用字体
sudo apt-get install -y ttf-ubuntu-font-family
sudo apt-get install -y fonts-freefont-ttf

# 刷新字体缓存
fc-cache -fv

# 检查字体是否安装成功
fc-list

Q：AS2报文发送，提示 "failed/failure:message-deemed-invalid-due-to-unknown-from-and.or-to-parties" 错误

问题现象：

AS2报文发送，提示 "failed/failure:message-deemed-invalid-due-to-unknown-from-and.or-to-parties" 错误

A: 解决方案：

与接收方核对，是否正确配置发送方的AS2 ID。因为接收方无法识别发送方的AS2 ID。

Q：AS2报文发送时，出现随机发送失败问题，失败时提示 "processed/Error: integrity-check-failed"

问题现象：

AS2报文发送时，出现随机发送失败问题，失败时提示“processed/Error: integrity-check-failed”，导致MDN发送失败。

A: 问题分析：

合作伙伴配置AS2服务时，同一域名对应多个IP（可能是做负载均衡）。因为配置问题，有部分服务无法连接或者证书设置不一致，导致访问到有问题的AS2服务器时，出现签名校验失败问题。

解决方案：

合作伙伴配置证书必须保持一致。

Q：对方返回CONTRL的EDI报文中UCI04标签问题

UCI04中的Action Code会反映出对方是否接收此报文以及报文中的问题，如果出现头部字段的问题就会返回4。

A: 问题分析：

UCI04中的Action Code会反映出对方是否接收此报文以及报文中的问题，如果出现头部字段的问题就会返回4。

正常情况会返回 7 或 8

Q：OFTP2发送失败，提示 NERP 校验失败

OFTP2发送失败，提示 NERP 校验失败。

警告信息： [WARN] Ignored the invalid NERP, Verify NERP failed, file hash verified failed

A: 问题根因：

Signed EERP Request - EERP请求签名开启开关不一致。

解决方案：

开启或关闭 EERP请求签名 开关，并且与合作伙伴配置保持一致。

Q：AS2报文发送时，提示 MDN签名校验失败

AS2报文发送时，提示“Signature Verification failed”，MDN签名校验失败，导致MDN发送失败。

A: 问题根因：

AS2 URL配置错误，导致MDN签名校验失败。

解决方案：

修改正确的 AS2 URL。

问题分析：

合作伙伴提供两个AS2 URL，分别对应 SHA256-1024bit 和 SHA256-2048bit，如果提供的证书是 1024bit，则只能使用 SHA256-1024bit 对应的URL。

Q：XML转换EDIFACT时出现报错提示 "Unexpected character ' ' (code 32)"

XML转换EDIFACT时出现报错 The edi xml file is invalid.Unexpected character ' ' (code 32); expected a semi-colon after the reference for entity 'Z'。

A: 问题根因：

因为解析出的XML中包含特殊字符< > & " ',直接写在要解析的XML中在解析时会出现上述报错。

解决方案：

在解析可能包含此类字符的字段时使用XML_ENCODE()方法进行转义。

Q：如何配置负载均衡

A: 负载均衡配置如下：

当前使用 nginx 作为负载均衡的服务器。 nginx 配置如下：

# 需要加载ngx_stream_module, 如何没有需要下载并安装该模块
# load_module /usr/lib64/nginx/modules/ngx_stream_module.so;

stream{
    upstream AS2 {
        server 192.168.122.20:5091 weight=1;
        server 192.168.122.21:5091 weight=1;
    }

    server{
        listen 192.168.122.20:5090;
#        server_name 192.168.122.20;
        proxy_pass AS2;
    }
}