Forgottenserver项目中的"Failed to Create Session"问题分析与解决方案

问题背景

在Forgottenserver项目（一个开源的MMORPG服务器模拟器）中，用户报告了一个常见的登录问题：当尝试连接服务器时，客户端会收到"Failed to create session"错误提示。这个问题主要出现在使用特定版本的MySQL/MariaDB数据库和特定客户端组合的情况下。

问题现象

用户在尝试登录时遇到以下典型表现：

1. 服务器控制台显示正常启动
2. 客户端能够连接到服务器
3. 在输入账号密码后，出现"Failed to create session"错误
4. 问题同时出现在本地环境和远程服务器环境中

根本原因分析

经过开发者社区的分析，这个问题主要源于以下几个方面：

1. 会话密钥生成与存储机制：服务器生成的会话密钥在存储到数据库时格式不兼容
2. 数据库兼容性问题：特定版本的MySQL/MariaDB对二进制数据的处理方式存在差异
3. 客户端协议支持：部分客户端（如Mehah的OTClient）默认不支持当前服务器协议版本

解决方案

方案一：修改ProtocolLogin.cpp代码

开发者froomzim提出了一个有效的解决方案，通过修改会话密钥的生成和存储方式：

// 生成并添加会话密钥
static std::independent_bits_engine<std::default_random_engine, CHAR_BIT, unsigned short> rbe;
std::string sessionKey(16, '\x00');
std::generate(sessionKey.begin(), sessionKey.end(), std::ref(rbe));

output->addByte(0x28);
output->addString(tfs::base64::encode({sessionKey.data(), sessionKey.size()}));

// 将会话密钥转换为十六进制
std::string sessionKeyHex;
for (unsigned char c : sessionKey) {
    sessionKeyHex += fmt::format("{:02x}", c);
}

// 将会话插入数据库
if (!db.executeQuery(fmt::format(
        "INSERT INTO `sessions` (`token`, `account_id`, `ip`) VALUES (UNHEX('{}'), {}, INET6_ATON('{}'))",
        sessionKeyHex, account.id, getConnection()->getIP().to_string()))) {
    disconnectClient("Failed to create session.\nPlease try again later.", version);
    return;
}

这个修改确保会话密钥以正确的十六进制格式存储到数据库中，解决了与数据库的兼容性问题。

方案二：客户端配置调整

对于使用特定客户端（如OTClient）的用户，需要进行以下调整：

1. 修改entergame.lua：

   • 将ip = world.externaladdress改为ip = world.externaladdressunprotected
   • 将port = world.externalport改为port = world.externalportunprotected

2. 修改features.lua：

   • 注释掉g_game.enableFeature(GameSequencedPackets)

3. 扩展支持的客户端版本列表： 在game.lua中添加1310到支持的客户端版本列表中

方案三：服务器配置调整

1. 修改config.lua中的httpPort设置，避免与现有服务冲突
2. 确保Apache/Nginx等web服务器不会占用相同端口
3. 检查数据库连接配置是否正确

验证与测试

经过社区成员测试，上述解决方案在以下环境中验证有效：

• Windows 11系统
• XAMPP环境（Apache + MySQL）
• MariaDB 10.4.32
• 多种客户端版本（包括OTClient和官方客户端）

最佳实践建议

1. 数据库选择：推荐使用MariaDB 10.4或更新版本
2. 客户端选择：对于新手，建议使用官方13.10客户端
3. 开发环境：本地测试推荐使用XAMPP等集成环境
4. 代码维护：定期同步Forgottenserver的最新代码，获取问题修复

总结

"Failed to create session"问题是Forgottenserver项目中一个典型的数据库与协议兼容性问题。通过理解会话管理机制和数据库存储原理，开发者提出了多种有效的解决方案。对于项目维护者来说，这个问题也提示了需要在代码健壮性和向后兼容性方面进行更多考虑。

对于遇到类似问题的开发者，建议首先尝试修改ProtocolLogin.cpp中的会话处理逻辑，这是最根本的解决方案。同时，根据使用的具体客户端和环境进行适当的配置调整，可以确保整个系统的稳定运行。