# 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生效。

特殊场景配置说明：如果客户有自己的负载均衡器 ，如 客户端 → 客户的SLB/ELB或F5负载均衡 → OA主|OA从，此场景下需要在OA前面部署Nginx，并且上面plugin.proerties中的ai.comibuilderServer参数地址配置任意一个Nginx地址即可，正确运行的逻辑图如下：

√ plugin.proerties中的 `ai.comibuilderServer` 配置任意一个Nginx地址即可
客户端 → 客户LB或F5负载均衡 → Nginx节点1负载均衡 → OA主|OA从
                          → Nginx节点2负载均衡 → OA主|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: 数据源配置异常

问题：部署Nginx并且配置协同的代理地址后，测试访问协同报错：400 Bad Request - Request Header Or Cookie Too Large

解决方案：问题异常来自于Nginx，重点检查Nginx配置。经过排查发现原因是：Nginx代理协同的地址配置错误，错误将OA代理地址配置成NG自己的IP和监听端口，造成一直在访问NG自己，最终出现异常。修改成正确的OA服务器IP端口，重启NG配置使其生效即可。

# 12、管理员没有CoMiBuilder菜单

问题：按照手册部署了CoMi，但是访问系统管理员看不到CoMiBuilder菜单

解决方案：

1、可能是当前OA版本未适配CoMi：需要根据CoMi的环境准备手册检查OA的适配情况
2、可能是未打低版本适配补丁包：如果当前OA版本和Build适配了CoMi，则需要进一步确认OA是否未打适配补丁包
3、可能是加密狗无相关插件：需要确保加密狗有CoMi所需插件

OA和CoMi V1.1关联参考链接：《CoMi V1.1环境准备手册 (opens new window)》

# 13、个人空间未显示CoMi超级入口（小章鱼图标）

问题：CoMi后台已经按照手册配置模型、初始化应用成功、授权用户应用，但前台普通用户未显示CoMi超级入口小章鱼图标。

解决方案参考FAQ：【个人空间未显示CoMi超级入口（小章鱼图标） (opens new window)】

# 14、访问CoMi Builder菜单提示：非法请求，请刷新页面后再尝试!

问题：后台管理员访问CoMiBuilder页面报错，提示 {"code":"401","message":"非法请求,请刷新页面后再次尝试!"}

解决方案：检查AI-Manager服务下application.yaml里面的v5Address配置，要求该地址是Nginx的地址-Nginx代理V5的地址和端口。

# 15、启动AI-Manager报错

问题现象截图：

解决方法：

1、检查qdrant是否正常启动
2、检查ai-manager的配置文件，qdrant地址配置是否正确
3、操作系统文件句柄数是否修改为65535，（ulimit -a查看，ulimit -n 65535临时修改，永久修改/etc/security/limit.conf配置文件）

# 16、CoMi知识源配置点击保存提示“保存失败”

问题：为了实现全文检索推送，在CoMi知识源配置点击保存提示“保存失败”；查看logs_sy/error.log异常提示：修改全文检索配置失败: http

问题原因：配置错误 - base/plugin.properties中配置的ai.managerUrl地址多了一个http导致推送异常。

解决方案：修改上面错误ai.managerUrl地址，重启OA后重新操作即可。

扩展：CoMi知识源配置点击保存报错排查思路均可以通过先查看日志，分析配置文件，以及检查全文检索到AI-Manager服务连通性等方面解决。

# 17、修改了Nginx端口，重新配置AI-Manager的NG端口后连接检查一直不通过

使用智能部署工具修改AI-Manager中的Nginx端口后，在第二步连接校验一直不通过，错误信息如下：

Nginx服务状态检查未通过失败说明与建议：

Nginx连通性检查失败。请检查：1）Nginx服务是否正常运行；2）网络连接是否正常；3）防火墙设置是否正确；4）端口是否可访问。建议先修复网络连接问题再继续CoMi安装。失败的服务: 服务 ai-manager: 主机 (192.168.188.175) Nginx连通性检查失败 - Nginx HTTP响应异常，状态码: 502，执行命令为：curl -sk -o /dev/null -w '%{http_code}' --connect-timeout 5 --max-time 10 'http://192.168.188.168:8111';

排查方法：

1、可能是NG修改端口未生效，在Nginx服务器通过 netstat -ntlp | grep 端口号 命令查看NG端口是否生效
2、可能是NG修改的端口未通过防火墙放行，可以在CoMi服务器通过 telnet Nginx服务器IP NG端口测试，不通则防火墙放行端口
3、可能是OA未启动，可以通过浏览器 http://Nginx服务器IP:NG端口/seeyon 访问OA，如果报错，则先启动OA
以上1、2、3全部通了之后，再重新做连接校验

# 18、智能部署工具向导式部署应用提示：命令执行超时

问题：智能部署工具向导式安装，在最后自动化执行部署阶段报错：[ERROR] 服务名称 AI-Engine 智能引|擎任务执行环境安装脚本执行失败:命令执行超时

问题原因：服务器性能太差，执行命令脚本超时了（5分钟超时）。

解决方案：生产环境务必使用一个更好的服务器，测试环境可发支持单或上报BUG让研发出一个10分钟超时的补丁。

# 19、进入智能应用授权页面报错：could not execute batch

问题：CoMiBuilder后台访问没问题，初始化应用后到智能应用授权页面报错：DataException: could not execute batch

这个错误发生在OA后台，通过OA的logs_sy/error.log查找关键字分析报错根源是：列[DESCRIPTION]长度超出定义

解决方案：找到协同OA的数据库，检查ai_comi_info表的description字段长度，一般默认是255，这个长度太短导致报错，可以将其修改为1000的长度，再看问题是否还存在。

# 20、进入CoMiBuilder页面报错：用户得到授权，但是访问是被禁止的!

问题：部署CoMi之后，一切配置完成，访问后台CoMiBuilder报错：用户得到授权，但是访问是被禁止的!

通过查询ai-manager的log-error.log日志发现错误：Server returned HTTP response code: 401 for URL: https://xxxxxx/seeyon/rest/seeyon-comi/license

问题原因：问题是comi访问OA时，cookie上面的身份不正确导致异常，这种通常出现在负载均衡配置上。最常见的是客户有自己的负载均衡器的场景下，比如 客户端 → 客户自己的LB或F5 → OA ，这种场景下缺少Nginx或者Nginx管理错误，就会出现上面的问题。