Tolgee平台本地Docker环境下上下文翻译功能失效问题分析

问题现象

在使用Tolgee平台进行本地化开发时，开发者反馈在React+Vite项目中使用本地Docker环境运行Tolgee平台时，上下文翻译功能无法正常工作。具体表现为当尝试进行上下文翻译时，服务器返回400错误，错误信息为"invalid_authentication_method"。

环境配置

开发者使用的技术栈包括：

• React前端框架
• Vite构建工具
• @tolgee/react库
• 本地Docker运行的Tolgee平台

核心配置代码如下：

const tolgee = Tolgee()
    .use(DevTools())
    .use(FormatSimple())
    .init({
        language: 'de',
        apiUrl: "http://localhost:8085",
        apiKey: "{apiKey}",
    });

问题原因分析

经过技术团队验证，此问题出现在Tolgee平台v3.47.0版本中。根本原因是当平台运行在无认证模式(no auth mode)下时，上下文翻译功能无法正确处理认证流程，导致系统返回无效认证方法的错误。

解决方案

目前有两种可行的解决方案：

1. 启用认证模式：这是推荐的临时解决方案。开发者可以在平台配置中开启认证功能，这样上下文翻译功能就能正常工作。

2. 等待官方修复：技术团队已经确认了这个问题，预计会在后续版本中修复这个无认证模式下的功能异常。

技术建议

对于正在使用Tolgee平台进行本地化开发的团队，我们建议：

1. 如果项目处于开发初期，可以先启用认证模式继续开发工作
2. 关注Tolgee平台的版本更新，及时升级到修复此问题的版本
3. 在测试环境中充分验证上下文翻译功能，确保其符合预期

总结

本地Docker环境下Tolgee平台上下文翻译功能失效是一个已知问题，主要影响无认证模式下的使用体验。开发者可以通过临时启用认证模式来解决这个问题，同时等待官方发布修复版本。这个问题不会影响Tolgee平台的核心翻译功能，只涉及上下文翻译这一特定功能。