# CoMi部署配置常见异常解决方案

# 简述

本手册列举CoMi部署、配置中的常见问题和解决方案，供项目参考解决。

# CoMi常见问题

# 1、无Comi插件，或插件未分配注册数

解决方案：CoMi按注册数授权，在进行用户授权时会检测当前加密狗是否有注册数，开发狗、0注册数的加密狗用户无法授权。需要从商务申请带CoMi注册数的加密授权。

# 2-0、访问CoMi Builder页面提示An error occurred.

问题现象：F12查看请求提示backend红字异常，状态代码502 Bad Gateway

问题原因1：Nginx服务测试发现NG无法连通CoMi的AI-Manager服务，导致访问异常

解决方案：检查AI-Manager服务是否启动正常；如果服务正常，则放行AI-Manager服务的8181端口防火墙再试。

问题原因2：协同OA侧plugin.properties配置的ai.comibuilderServer地址错误，比如配置成外网https，导致OA内网访问这个地址不通。

解决方案：修改配置，改成Nginx内网地址即可，否则OA可能无法连通NG导致502异常。

# 2-1、协同系统管理员访问CoMi Builder页面未正确显示，提示Not Found

解决方案：CoMi Builder访问的是CoMi服务的页面，满足如条件即可正常访问：

1）确保部署了CoMi相关服务
2）必须参考【Nginx服务代理配置】章节，将CoMi相关请求配置到NG
3）访问协同系统必须通过Nginx代理到协同OA的地址
4）nginx.conf中的 upstream ai_manager{} 代理地址对应的是AI-Manager服务器IP和端口
1. 参考“4、协同进入Comi Builder页面，直接提示Error Page 404错误”检查AI-Manager的static-location

# 2-2、集团或单位管理员进入智能问数提示Not Found

注意这是智能问数的Not Found解决方案：需要确保智能问数服务器处于启动并可用状态，并且Nginx需要代理问数BI：

1）确保BI是否正确安装和授权：通过浏览器能访问协同驾驶舱高级版平台（http://服务器ip:8058/），并且参考手册完成了初始化
2）确保Nginx已经配置和代理BI服务：需要参考手册在nginx.conf配置include comi.conf和加入Bi的代理地址

# 3、协同进入Comi Builder页面，直接提示Error Page 500错误

解决方案，目前已知两种情况会出现此问题：

1、AI-Manager服务未启动成功，通过【AI-Manager启停和维护】章节，检查服务的nohup.out日志，分析服务状态。
2、AI-Manager服务器无法访问到Nginx，比如ai-manager下的application.yaml配置v5Address地址错误，该地址需要指向Nginx代理OA的地址，并且ai-manager服务器能访问到Nginx

# 4、协同进入Comi Builder页面，直接提示Error Page 404错误

配置问题，ai-manager的静态文件路径配置错误！参考【修改application.yaml】章节，检查static-locations参数，此路径一定要在AI-Manager的程序运行路径下。加入AI-Manager的程序路径在 /data/Seeyon/Comi/app/ai-manager，则static-locations参数中的 ai_manager 需要改成 ai-manager 。

# 5、AI-Manager连接人大金仓（电科金仓）数据库启动报错

启动ai_manager，查看日志发现大量 ERROR: null value in column "create_user_name" violates not-null constraint 字样的错误。这个问题原因是金仓数据库不支持空字符串插入导致的异常，需要联系金仓数据库厂商配置数据库参数关闭。

-- 注意：人大金仓建库后需要先查询看下是否支持空字符串插入，sql语句如下：
select name,setting from  sys_settings where name = 'ora_input_emptystr_isnull' ;
-- 若结果显示为on，需要修改kingbase.conf中的ora_input_emptystr_isnull=off

# 6、初始化CoMi应用时，文案策略、安全助理等智能体应用部署失败

文案策略、安全助理等智能体应用初始化失败，尝试重新初始化也不行。通常问题原因和解决方案如下：

1、确保参考【初始化CoMi应用】章节，一步一步操作，不能遗漏

2、确保模型页签下测试LLM和Embedding模型状态OK，未测试模型会导致初始化失败

3、这几个应用会先调用Embedding模型进行向量化，再写入qdrant向量数据库，如Embedding和qdrant服务不正常会导致初始化失败

4、初始化超时时间5分钟，如服务器性能太差，未在设定时间内初始完成会导致失败。

5、如Embedding模型采用本地，检查文本向量模型服务器负载，CPU长期100%易导致初始化失败，考虑提升服务器配置。

# 7、curl模型能通，telnet不通，管理员后台测试模型提示HTTP connect timed out

已确认在ai_manager服务器进行curl命令能连通大模型

但是按规则配置后测试模型提示：I/O error on POST request for "http://xxxx/v1/chat/completions":HTTP connect timed out

在ai_manager服务器通过telnet 模型IP 模型端口同样不通。

问题原因：最终确认问题原因是comi那台服务器没有开通访问大模型IP端口的网络权限，curl能连通是因为走到了代理。

解决方案：需要客户明确开网络策略，能让comi服务器访问到大模型真实服务器。

如何判断模型能通：第一需要curl测试通，第二需要telnet通，确保这两条命令都OK才行！

# 8、进入Comi应用授权页面提示：获取应用列表失败

登录OA集团管理员后台，进入智能应用设置——Comi应用授权页面，报错：获取应用列表失败

检查ctp日志，有对应报错：

可以看到是oa服务器访问comi（ng代理的地址）超时了，这个问题的根本原因是：OA侧无法通过Nginx连接到ai-manager，具体有两种可能性：

第一种：OA无法访问Nginx，导致没法通过Nginx代理到AI-Manager
第二种：OA侧的ai.comibuilderServer参数配置错误，没有配置成Nginx代理Ai-Manager的地址

检查协同OA部署目录下的 base/conf/plugin.properties 文件，看ai.comibuilderServer配置的什么地址，看地址是否能在OA侧访问，地址IP端口是否配置错了！

修改配置后，需要重启协同OA才能生效！

# http://192.168.188.143是Nginx代理的地址，请按照实际情况修改
ai.comibuilderServer=http://192.168.188.143/seeyon/ai-platform/ai-manager/assistant/info/getAllRightsAssistant

另外一种现象：进入智能应用设置——Comi应用授权页面，报错：json转换报错，格式不正确。此问题通过ctp.log、error.log分析也是“获取应用列表失败”引起，解决方案同上。

# 9、进入CoMi应用授权页面提示：访问comi应用列表失败

登录OA集团管理员后台，进入智能应用设置——Comi应用授权页面，报错：访问comi应用列表失败：请检查ng配置的url或者网络连接是否正常

解决方案：检查协同OA的base/conf/plugin.properties配置，配置一定要按照要求调整（详见“协同配置CoMi并启动”章节）：

配置中的 ai.comibuilderServer 设置为Nginx访问协同OA的地址
配置中的 ai.managerUrl 则是对应AI-Manager的服务IP和端口，不是走NG
配置中的 ai.comi.apikey 则是对应系统管理员CoMiBuilder服务下面配置的apikey

以上配置无误后，重启下协同OA生效。

# 10、启动comi后，通过协同访问CoMiBuilder菜单异常

查看ai-manager的nohup.out日志存在如下异常：Factory method 'dataSource' threw exception with message: 数据源配置异常

解决方案：可能是依赖服务未启动导致不可用，确保数据库处于启动状态，然后重启下ai-manager服务，问题或许就解决了。

Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'aiToolInfoService': Unsatisfied dependency expressed through field 'aiToolInfoDao': Error creating bean with name 'aiToolInfoDao' defined in URL [jar:nested:/data/Seeyon/Comi/app/ai-manager/ai-manager-assemble-1.1.0.jar/!BOOT-INF/lib/ai-manager-biz-1.0.0-SNAPSHOT.jar!/com/seeyon/ai/manager/domain/dao/AiToolInfoDao.class]: Unsatisfied dependency expressed through bean property 'sqlSessionFactory': Error creating bean with name 'sqlSessionFactory' defined in class path resource [com/seeyon/ai/manager/common/mybatis/MybatisAutoConfiguration.class]: Unsatisfied dependency expressed through method 'sqlSessionFactory' parameter 0: Error creating bean with name 'dataSource' defined in class path resource [com/seeyon/ai/manager/common/datasource/DataSourceAutoConfiguration.class]: Failed to instantiate [javax.sql.DataSource]: Factory method 'dataSource' threw exception with message: 数据源配置异常