学习目标

熟悉K/3 Wise的组件跟踪工具-KDmainDBG的使用和结果分析
熟悉COM+组件和非COM+组件的注册

文档约定

文档中所述目录路径“X:\Kingdee\K3ERP”表示K/3 WISE的安装目录，根据安装时的实际安装目录修改。
文档中“Program Files (x86)”均表示64位操作系统中目录，32位操作系统修改为“Program Files”即可。
文档中“C:\Program Files (x86)\Common Files\Kingdee\K3”目录不随K3Wise安装目录变动，“C:\Program Files (x86)\Common Files”为操作系统固定目录。

一、K/3Wise跟踪工具-KDmainDBG概述

K/3 从 10.2 版本开始，其客户端的安装目录中附带了一个功能强大的调试工具：KdMainDBG.exe，该工具可以跟踪 COM+组件的运行情况。

文件的路径：X:\Kingdee\K3ERP目录下，其执行文件的名称是 KdMainDBG.exe。

二、KdMainDBG组件跟踪操作方法

2.1、找到金蝶安装目录“X:\Kingdee\K3ERP下的KdMainDBG.exe”（右键桌面金蝶k/3 wise图标，选择【打开文件位置】直接到K3ERP文件夹下搜索【kdmaindbg】）；

2.2、右键该程序，选择“以管理员身份运行”，打开KdMainDBG.exe，打开会提示“您使用的是K/3调试版本”，点击“确定”进入，如图2-1-1所示：

图 2-1-1 提示调试跟踪版本

2.3、点击【确定】后，程序会自动打开K/3 主控台的登陆窗口（如果未出现登录窗口，请参考后续常见问题处理），同时也会开启一个组件跟踪窗口，实时记录当前K/3 组件的调用情况，如果有组件出现异常，那么通过它非常方便定位问题并解决问题，另外该工具还跟踪了对象的执行时间，可以用来检测性能数据。如下图2-1-2所示：

图 2-1-2 打开跟踪工具后出现K3客户端登录窗口

2.4、在出现的登录界面登录，然后操作到报错的地方，报错出现后，点击【确定】，然后查看跟踪工具界面；当我们跟踪到有组件出现错误时，会出现一条红色显示的记录，表示该组件调用异常，如图2-1-3错误示例：

（注意：“Mts. MtsGrp.1”和“KDPSInfo. KDPSI” 两个组件红色可以忽略）

组件错误示例.png

图 2-1-3 监控到的错误组件为红色显示

2.5、部分情况下会跟踪到多个组件错误情况，一般按照顺序处理，即先找到最先出现的报错组件进行处理注册后，重新跟踪确认后续组件是否正常，依次循环处理即可。

三、组件跟踪分析

3.1、组件的认识

组件跟踪结果的分析，需要首先认识熟悉K/3的组件，K/3系统中的组件包括了中间层组件和客户端组件，同时组件分为两大类：COM+组件和非COM+组件。

COM+组件主要包括VBR和DLL，客户端上VBR和中间层服务器上DLL一一对应，名称相同，扩展名不同，服务器上的DLL分功能模块形成EBO组件包；COM+组件文件名记录在服务器上的MtsSpSetup.lst文件中，每个文件名对应一个VBR和DLL文件，分功能模块组合成EBO组件包，文件位置：X:\Kingdee\K3ERP\KDSYSTEM\KDCOM\MtsSpSetup.lst”；

非COM+组件主要包括“.ocx”和“.dll”文件，服务器和客户端均存在，为系统运行必须的基础环境组件，非COM+组件文件记录在客户端“K3ComponentInfo.INI”文件中；文件位置：64位操作系统为：“C:\Program Files (x86)\Common Files\Kingdee\K3”。

☀ 具体详情请参考文章《K/3 Wise组件的认识》https://vip.kingdee.com/school/164744013625454848

3.2、组件问题定位

3.2.1 几种常见报错类型

① ActiveX部件不能创建对象

图 3-2-1 常见报错类型1

② Automation错误

图3-2-2 常见报错类型2

③ 定义的应用程序或对象错误

A定义的应用程序或对象错误.png

图3-2-3 常见报错类型3

④ 未设置对象变量或With Block变量

A未设置对象变量或Withblock对象.png

图3-2-4 常见报错类型

3.2.2 同一个操作服务器和客户端均报错

如果是服务器上和客户端均报错，那么需要首先在服务器上重新注册组件，一般的服务器报错会带动所有客户端都报错，服务器正常了，客户端也就正常了。服务器上组件报错分为两种，COM+组件和非COM+组件，根据跟踪结果组件名称如果在“MtsSpSetup.lst”中查找到对应名称即为COM+组件报错，按文章第3.3节“服务器上COM+组件的注册”方法进行注册，如果在“K3ComponentInfo.INI” 文件中查找到对应名称即为非COM+组件报错，按文章第3.4节“非COM+组件的注册”方法进行注册。

3.2.3 只有客户端报错

如果只有个别客户端报错，在客户端运行KdMainDBG跟踪组件，定位到报错组件名称，同样根据跟踪结果组件名称如果在“MtsSpSetup.lst”中查找到对应名称即为COM+组件报错，按文章第3.4节“客户端COM+组件的注册”方法进行注册，如果在“K3ComponentInfo.INI” 文件中查找到对应名称即为非COM+组件报错，按文章第3.4节“非COM+组件的注册”方法进行注册。

3.3、服务器上COM+组件的注册（DLL组件）

3.3.1 工具注册：

服务器上【开始菜单】-【金蝶K/3Wise】-【中间层组件注册】，注意该工具是重新注册中间层所有COM+组件包，注册之前需要先将COM+应用程序里的ebo开头的组件包和加密组件kdsvrmgr删除，然后再运行中间层组件注册工具，慎重使用！

3.3.2 手动注册：

（这里以K3MClass.dll为例来介绍注册方法）

1、新建组件法：

a 首先通过KdMainDBG组件跟踪到报错组件K3MClass.dll;

b 打开MtsSpSetup.lst文件（X:\Kingdee\K3ERP\KDSYSTEM\KDCOM\MtsSpSetup.lst），查找K3MClass所属组件包，如下图，确认K3MClass属于组件包ebodesign：

COM+组件定位.png

图 3-3-1 MtsSpSetup文件记录COM+组件包列表

c 打开【控制面板】-【管理工具】-【组件服务】（或打开运行，输入“dcomcnfg”回车），打开组件服务，依次展开“组件服务”-“计算机”-“我的电脑”-“COM+应用程序”，找到 “ebodesign”，展开选中“组件”,如下图所示，如果其中存在K3MClass.***，则右键将其删除后新建组件，如果没有则直接新建组件：

COM+组件注册1.png

图 3-3-2 组件服务中定位组件位置

d 确认组件属性包后，鼠标右键选择ebodesign下“组件”，选择“新建”-“组件”，打开新建组件向导：

COM+组件注册2.png

图 3-3-3 新建组件

COM+组件注册3.png

图 3-3-4 组件安装向导

COM+组件注册4.png

图 3-3-5 安装新组件

e 切换到“X:\Kingdee\K3ERP\KDSYSTEM\KDCOM”，选择K3MClass.dll

COM+组件注册5.png

图 3-3-6 选择要安装的组件文件

COM+组件注册6.png

图 3-3-7 确认选择的组件安装情况

COM+组件注册7.png

图 3-3-8 完成新组件安装

f 点击“完成”后，如下图所示，在组件服务的右侧可以看到注册的K3MClass.*的文件：

COM+组件注册8.png

图 3-3-9 安装新组件后组件服务中显示

2、直接拖入法：

在k/3安装路径下“X:\Kingdee\K3ERP”（右键桌面金蝶k/3 wise图标，选择【打开文件位置】直接到K3ERP文件夹下）搜索找到此组件，将其拖入【控制面板—管理工具—组件服务—计算机—我的电脑—COM+应用程序—ebopublic】双击打开【组件】，将其拖到此处即可完成注册。

COM+组件注册9.png

图 3-3-10 拖入注册组件

拖入后，如图所示，组件服务中就存在K3MClass.**：

COM+组件注册8.png

图 3-3-11 拖入注册组件后组件服务中显示

3.4、客户端COM+组件注册（VBR组件）

3.4.1 工具自动注册

客户端的VBR文件可以通过在K/3客户端执行“远程组件配置”工具来进行自动注册，选择开始－程序－金蝶K/3-远程组件配置，打开远程组件配置窗口，如图3-4-1所示：

远程组件配置工具.png

图3-4-1 远程组件配置工具

3.4.2 手动注册

（这里以K3MClass.vbr为例来介绍注册方法）

1、打开操作系统开始菜单-运行，输入CMD回车（该方法必须确认运行窗口下有显示“使用管理权限创建此任务”，如下图3-4-1），如果没有显示“使用管理权限创建此任务”，则进入目录c:\windows\system32，找到“cmd.exe”，右键以管理员身份运行CMD：

图3-4-1 以管理员身份运行CMD

2、输入命令：c:\windows\SysWOW64\CLIREG32.EXE "X:\Kingdee\K3ERP\KDSYSTEM\K3MClass.VBR" 回车：

（X:\Kingdee\K3ERP\KDSYSTEM\K3MClass.VBR注意修改为K3MClass.VBR真是路径）

图3-4-2 输入CLIREG32命令注册VBR

图3-4-3 提示工具信息

3、点击“确定”，进入COM+组件VBR注册向导窗口，如下图3-4-4，选择“DCOM”，在“网络地址”中输入中间层服务器的IP地址，点击“确定”，未提示错误即正常：

图 3-4-4 注册信息输入

3.5、非COM+组件（*.dll和*.ocx）的注册

备注：可在K3ComponentInfo.INI中查看文件列表。文件位置：

64位操作系统为：“C:\Program Files (x86)\Common Files\Kingdee\K3”；

32位操作系统为：“C:\Program Files\Common Files\Kingdee\K3”。

中间层和客户端非 COM+组件均主要包含了DLL 和OCX 两种格式的文件，在K3ComponentInfo.INI文件列表中查询。

3.5.1 单个非COM+组件注册方法

（以组件Ledger50.ocx为例）

a 打开开始-运行，输入CMD回车（该方法必须确认运行窗口下有显示“使用管理权限创建此任务”，如下图3-4-1），如果没有显示使用管理权限创建此任务”，则进入目录c:\windows\system32，找到“cmd.exe”，右键以管理员身份运行CMD：

图3-5-1 需要运行时显示有“使用管理权限创建此任务”

图3-5-2 右键“以管理员身份运行”打开CMD

图3-5-3 运行后CMD窗口左上角有“管理员”

b 输入命令：regsvr32 “C:\Program Files (x86)\Common Files\Kingdee\Ledger50.ocx” 回车，提示注册成功即可，如下图3-4-4：

（C:\Program Files (x86)\Common Files\Kingdee\Ledger50.ocx为异常组件完整路径，根据组件进行修改）

非COM+注册成功.png

图3-5-4 非COM+组件注册成功

3.5.2 非COM+组件批量注册方法

1、金蝶K3系统不管服务器还是客户端，对非COM+组件提供了批处理注册方式，对存在大量非COM+组件异常时，可以运行批处理来进行全部非COM+组件重新注册。

2、批处理文件所在位置：C:\Program Files (x86)\Common Files\Kingdee\K3目录，该目录存在多个批处理文件，包括注册和反注册中间层和客户端的非COM+组件（注意：不管在服务器还是客户端均依次运行两个注册批处理文件进行注册）：

RegMiddleware.bat 注册服务器非COM+批处理文件；

RegProduct.bat 注册客户端非COM+批处理文件；

UnRegMiddleware.bat 反注册服务器非COM+批处理文件；

UnRegProduct.bat 反注册客户端非COM+批处理文件；

如图：

批处理文件.png

图3-5-5 批处理文件及说明

3、批处理注册非COM+操作方法：

进入目录“C:\Program Files (x86)\Common Files\Kingdee\K3”，右键要执行的批处理，选择“以管理员身份运行”，运行批处理进行注册：

批处理1.png

图3-5-6 右键“以管理员身份运行”运行批处理

批处理2.png

图3-5-7 批处理进度条显示

4、批处理运行异常处理

【问题】Win7、Win10操作系统下当使用非administrator登录操作系统或者administrator未获取全部内置管理员权限，双击运行批处理（RegProduct.bat或RegMiddleware.bat）提示“未预期错误”，或者右键“以管理员身份运行”批处理闪退。

【解决方案】

如果双击运行提示“未预期错误”，需要右键“以管理员身份运行”；

但在某些win10家庭版、专业版系统下，右键以管理员身份运行，会跳转到C:\Windows\system32\目录执行RegMe.exe，而不是当前文件夹，从而导致批处理无法执行，有两种方法处理该问题：

方法一、以管理员身份运行CMD，打开CMD后，输入cd C:\Program Files (x86)\Common Files\Kingdee\K3跳转到批处理目录，输入RegProduct.bat或RegMiddleware.bat回车运行；

方法二、编辑批处理（如图3-5-8），在批处理命令前添加如下命令即可正常右键批处理文件“以管理员身份运行”：

REM when run admin,into the current directory.

cd /d %~dp0

注：如果添加保存提示没有权限或跳出另存为窗口，取消弹出窗口，右键批处理文件选择属性，添加当前登录用户设置完全控制权限即可。

批处理.png

图3-5-8 添加run admin切换控制

四常见问题及处理方法

4.1 【问题1】：双击打开KdMainDBG.exe报错“未预期错误，退出”。

【解决方法】：鼠标右键，选择“以管理员身份运行”。

4.2 【问题2】：打开KdMainDBG后，窗口中空白无内容且未弹出K3客户端登录界面，或者弹出后提示“Kdmain.exe已停止工作”等。

【解决方法】：此问题一般因操作系统数据执行保护引起，需要关闭数据执行保护DEP。

关闭数据执行保护（DEP）功能的方法：【控制面板】-【系统和安全】-【系统】-【高级系统设置】-【性能】-【设置】-【数据执行保护】，勾选“仅为基本的windows程序和服务启用DEP”。

如果上述关闭还有异常，请执行命令完全关闭：

① 请使用管理员用户administrator登录电脑。打开桌面左下角的【开始】菜单，【所有程序】→【附件】右键单击【命令提示符】然后选择【以管理员身份运行】。

② 打开CMD后，输入命令“bcdedit.exe /set nx AlwaysOff”，然后回车。之后会出现“操作成功完成”提示。再重启计算机后即可完成数据执行保护（DEP）功能的关闭。"

4.3 【问题3:】：运行cmd，输入命令regsvr32注册非COM+组件时，提示：模块"****"已加载,但找不到入口点DllRegisterServer。

【解决方法】：该提示分两种情况，一是使用了非管理员用户打开CMD进行注册，如果命令提示符CMD窗口左上角未显示“管理员”，请重新找到C:\Windows\System32\cmd.exe，右键选择“以管理员身份运行”，确保打开窗口左上角有显示“管理员”；二是如果确认是管理员，请确认该注册组件文件正确及路径正确，或者拷贝正常可以注册的客户端相关问题替换再注册。

K/3 Wise排错神器--KdMainDBG组件的跟踪和注册

恭喜您！