使用googletrans将pandas DataFrame英文列译为法语时翻译结果仍为英文

这个问题的本质是googletrans库存在静默失效机制：当接口连通失败、被限速、版本适配异常时，库不会抛出可捕获的错误，而是直接将原文作为“翻译结果”返回，模拟出代码执行成功的假象。可按照以下步骤逐一排查修复：

1. 替换存在适配bug的旧版本库 #

pip源默认安装的3.0.0-alpha版本的googletrans，内置的Google接口token校验逻辑已经失效，根本无法正常请求翻译接口，且无报错提示。

• 修复操作：
  1. 卸载当前环境的旧版googletrans
  2. 安装经过社区修复的4.0.0-rc1版本：

  pip uninstall googletrans -y
  pip install googletrans==4.0.0-rc1
  

2. 优化翻译对象初始化配置 #

默认初始化的Translator() 仅绑定单个翻译服务节点，一旦该节点被限流、访问不通，就会触发静默返回原文的逻辑。

• 修复操作：初始化时主动配置多节点地址，提升接口连通稳定性：

from googletrans import Translator
translator = Translator(
    service_urls=[
        'translate.google.com',
        'translate.google.co.jp',
        'translate.google.de'
    ]
)

3. 替换无容错的批量apply逻辑 #

你之前写的两种apply写法都没有异常捕获和请求限速控制：短时间内批量发送请求会触发Google翻译的临时访问限制，被限制后同样会静默返回原文。

• 修复操作：封装带延时、空值处理、异常捕获的翻译函数，替代匿名apply写法：

import time
import pandas as pd

def translate_to_fr(text):
    # 跳过空值，避免接口报错
    if pd.isna(text) or not str(text).strip():
        return ""
    try:
        res = translator.translate(str(text), src='en', dest='fr')
        # 每完成一次请求加200ms延时，避免触发批量访问限制
        time.sleep(0.2)
        return res.text
    except Exception as e:
        print(f"单条翻译失败，原文本：{text}, 错误：{e}")
        return str(text)

# 应用到DataFrame目标列
data['phrase'] = data['sentence'].apply(translate_to_fr)

4. 批量操作前的连通性校验 #

在执行全量列翻译前，先通过单条测试确认接口真的生效，避免跑完整个流程才发现结果不对：

# 测试用例：正常应返回法语"Bonjour le monde"
test_output = translator.translate("Hello world", src='en', dest='fr').text
print(f"连通性测试结果：{test_output}")
# 如果返回值和原英文完全一致，说明接口还未连通，需继续排查节点、版本问题，不要直接跑全量翻译

注意：不要跳过连通性测试步骤直接跑全量apply，否则一旦接口未正常连通，生成的新列会完全保留原英文内容，且全程无任何报错提示。

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