自编译Apache Guacamole版本中JSON认证无法正常工作求助

自编译Apache Guacamole 1.5.5客户端，未修改任何代码，但Encrypted JSON认证功能失效，相同版本的Docker镜像可正常使用该认证方式。已确认pom.xml版本、JSON扩展加载状态、环境变量均与Docker版一致，自编译版本地存储多了GUAC_AUTH_TOKEN变量，发送/api/tokens请求返回Invalid login。

1. 排查前端编译环境与依赖 #

• 确认Node.js版本匹配：Guacamole 1.5.x前端编译对Node.js版本有明确要求（推荐16.x系列），检查本地Node.js版本是否与官方Docker镜像中使用的版本一致。版本不匹配可能导致编译后的JS逻辑出现差异，比如本地存储处理、认证请求构造逻辑。
• 清理编译缓存重编：删除前端项目目录下的node_modules、dist文件夹，重新执行：

  npm install
  npm run build
  

  避免旧缓存文件导致的代码残留问题。

2. 验证前端代码与官方版本一致性 #

• 对比官方1.5.5 Tag代码：用Git将本地前端代码（guacamole-client/guacamole-common-js、guacamole-webapp）与官方1.5.5标签的代码对比，确认无无意修改或文件缺失，重点检查认证相关逻辑文件（如AuthService.js、存储处理相关代码）。
• 检查编译后资源：对比自编译版与Docker版的guacamole.js文件，搜索GUAC_AUTH、JSONAuthentication等关键词，确认自编译版包含完整的JSON认证逻辑。

3. 对比认证请求细节 #

用浏览器开发者工具（Network面板）对比两个版本的认证流程：

• 确认自编译版是否正确读取GUAC_AUTH本地存储变量，检查变量的格式、内容是否与Docker版完全一致（注意是否存在全角空格、转义字符异常等）。
• 查看/api/tokens请求的参数、请求头、请求体格式：
  • 确认Docker版是否携带额外请求头（如Content-Type）；
  • 确认自编译版的请求体是否与Docker版完全一致（比如是否正确使用application/x-www-form-urlencoded格式传递token参数）。
• 追踪GUAC_AUTH_TOKEN变量的赋值逻辑：对比Docker版前端代码，确认该变量是否为自编译版新增的冗余逻辑，是否干扰了原有GUAC_AUTH的使用。

4. 后端扩展与日志排查 #

• 确认JSON扩展完整性：确保使用的guacamole-auth-json.jar是官方1.5.5版本（而非自编译版本，除非确认自编译无错误），对比官方jar包的文件结构与内容。
• 开启DEBUG日志：在Guacamole配置中开启org.apache.guacamole.auth.json的DEBUG级别日志，查看认证请求到达后端时的详细处理过程，是否存在token解密失败、数据源匹配错误等日志信息。

5. 手动验证本地存储逻辑 #

手动在自编译版的浏览器控制台执行以下代码，设置正确的GUAC_AUTH变量后刷新页面：

localStorage.setItem('GUAC_AUTH', JSON.stringify({
    "authToken": "858056C32F92817445D215897B18A08EFEB257A29BDEA8638F5FBC20A17243DF",
    "username": "feef183c-4a29-42a2-985a-581f06f93135",
    "dataSource": "json",
    "availableDataSources": ["postgresql", "postgresql-shared", "json"]
}));

• 如果手动设置后认证正常，说明你的代码写入GUAC_AUTH的时机或格式存在问题（比如写入时使用了转义的"而非正常双引号，或DOM未加载完成就写入）。
• 如果手动设置仍无效，说明前端读取或使用GUAC_AUTH的逻辑存在编译异常。

内容的提问来源于stack exchange，提问作者PedroAltatech