comunes/kune项目常见问题排查指南

前言

comunes/kune是一个基于GWT开发的协作平台项目，在开发和部署过程中可能会遇到各种技术问题。本文将从技术专家的角度，系统梳理kune项目中最常见的故障现象及其解决方案，帮助开发者快速定位和解决问题。

1. 服务器启动问题

1.1 服务器卡在"INFO: Starting server"状态

问题现象：启动kune服务器时，日志显示卡在"INFO: Starting server"状态，无法继续启动。

原因分析：这通常是由于wave-server.properties配置文件中指定的resource_bases目录不存在导致的。

解决方案：

1. 检查wave-server.properties配置文件
2. 确认resource_bases参数指定的目录路径是否正确
3. 如果目录不存在，创建相应目录或修改配置为正确的路径

1.2 "Too many files open"错误

问题现象：运行kune测试时出现"Too many files open"错误。

原因分析：系统文件描述符限制过低，无法满足kune运行时的文件打开需求。

解决方案：

1. 检查当前系统的文件描述符限制：ulimit -n
2. 提高限制值（建议至少设置为10240）
3. 对于Linux系统，可修改/etc/security/limits.conf文件永久生效

2. 数据库相关问题

2.1 MySQL访问被拒绝

问题现象：出现Access denied for user 'kune'@'localhost'错误。

解决方案：

1. 确认kune.properties中的数据库密码与MySQL中设置的密码一致
2. 如密码错误，需重置MySQL用户：

DROP USER kune@localhost;
GRANT ALL PRIVILEGES ON kune_prod.* TO kune@localhost IDENTIFIED BY 'db4kune';
GRANT ALL PRIVILEGES ON kune_openfire.* TO kune@localhost IDENTIFIED BY 'db4kune';
FLUSH PRIVILEGES;

3. 修改配置后执行mvn compile确保新配置生效

2.2 Liquibase迁移失败

问题现象：执行bin/liquibase-migrate.sh时出现迁移失败错误。

解决方案：

1. 检查具体错误信息，通常是表结构变更冲突
2. 手动执行相应SQL语句解决冲突，例如：

ALTER TABLE groups DROP COLUMN logoLastModifiedTime;

3. 重新运行迁移脚本

3. 索引和搜索问题

3.1 Lucene索引损坏

问题现象：启动时出现CorruptIndexException: Unknown format version错误。

解决方案：

1. 停止kune服务
2. 删除索引目录：/var/lib/kune/lucene/kune*/indexes*
3. 重新启动服务，系统会自动重建索引

3.2 Wave索引问题

问题现象：服务启动缓慢或卡在特定wave处理上。

解决方案：

1. 使用lsof <pid>命令检查服务进程打开的文件
2. 如发现特定wave文件导致问题，临时移除此wave目录
3. 确保启动前删除/var/lib/kune/_wave_indexes/write.lock文件

4. 编译和构建问题

4.1 GWT编译错误

问题现象：出现Error generating CoreResources等GWT编译错误。

原因分析：可能是文件描述符不足或GWT版本兼容性问题。

解决方案：

1. 检查并提高系统文件描述符限制（见1.2节）
2. 确保使用兼容的GWT版本
3. 清理项目并重新构建

4.2 Maven构建问题

问题现象：构建时出现Plugin execution not covered by lifecycle等Maven错误。

解决方案：

1. 确保安装了m2eclipse插件
2. 更新Maven项目配置
3. 检查pom.xml文件中的插件配置

5. 客户端调试技巧

5.1 提高客户端日志级别

方法：在URL中添加?log_level=DEBUG#参数，例如：

http://localhost:8080/?log_level=DEBUG#

5.2 使用Firebug调试

1. 安装Firefox浏览器和Firebug插件
2. 打开Firebug控制台
3. 查看GWT应用的详细日志输出

6. 常见编码问题

6.1 UTF-8编码错误

问题现象：出现Incorrect string value等字符编码错误。

解决方案：

1. 确保系统支持UTF-8编码
2. 在Debian/Ubuntu系统上检查/etc/locale.gen配置
3. 执行locale-gen命令重新生成locale

7. Eclipse开发环境优化

7.1 提高Eclipse性能

1. 禁用不必要的验证器
2. 增加Eclipse内存设置
3. 关闭不需要的插件和功能

7.2 GWT开发问题

问题现象：Eclipse中GWT开发时出现各种奇怪错误。

解决方案：

1. 检查GWT Designer配置，禁用不必要的选项
2. 清理项目并重新构建
3. 检查运行配置，必要时删除并重新创建

结语

本文总结了comunes/kune项目开发和使用过程中最常见的各类问题及其解决方案。遇到问题时，建议按照以下步骤排查：

1. 仔细阅读错误日志，定位问题根源
2. 根据错误类型参考本文相应章节
3. 如问题仍未解决，可检查项目文档或社区讨论

希望本指南能帮助开发者更高效地解决kune项目中的技术问题。随着项目发展，可能会遇到新的问题，建议保持对项目更新的关注，及时获取最新的解决方案。