Python调用JS函数时出现UnicodeEncodeError该如何解决编码问题？

在Python与JS的混合开发场景中，调用JS函数时遇到UnicodeEncodeError是非常常见的问题，这类错误通常出现在参数传递、返回值处理等环节，核心原因是字符编码不匹配导致Unicode字符无法正确转码。

常见错误场景复现

假设我们使用PyExecJS库调用JS函数，传递包含中文的参数时，很容易触发编码错误：

import execjs

# 待调用的JS代码
js_code = '''
function greet(name) {
    return "你好，" + name;
}
'''

# 初始化JS环境
ctx = execjs.compile(js_code)

# 传递中文参数，可能触发UnicodeEncodeError
try:
    result = ctx.call("greet", "张三")
    print(result)
except UnicodeEncodeError as e:
    print("编码错误：", e)

错误原因分析

• Python默认字符串为Unicode编码，而部分JS运行环境或调用库默认使用本地编码（如GBK），传递中文时会出现编码转换失败。
• JS函数返回的结果包含非ASCII字符时，调用库在将结果转回Python字符串时没有正确处理编码。
• 如果系统环境变量配置的默认编码不是UTF-8，也会加剧编码不匹配的问题。

针对性解决方案

方案一：统一设置编码为UTF-8

在调用前手动设置Python的默认编码，同时保证JS代码的编码也为UTF-8：

import sys
import execjs

# 设置Python默认编码为UTF-8
if sys.version_info[0] == 2:
    reload(sys)
    sys.setdefaultencoding('utf-8')
elif sys.version_info[0] == 3:
    # Python3默认字符串为Unicode，无需额外设置默认编码，仅需保证传输内容编码正确
    pass

# JS代码明确使用UTF-8编码
js_code = '''
function greet(name) {
    // JS内部字符串为UTF-16编码，无需额外处理，正常拼接即可
    return "你好，" + name;
}
'''

ctx = execjs.compile(js_code)
# 传递参数时显式转码为UTF-8
param = "张三".encode("utf-8").decode("utf-8") if sys.version_info[0] == 2 else "张三"
result = ctx.call("greet", param)
print(result)

方案二：使用JSON作为中间传输格式

通过JSON序列化传递参数和接收返回值，JSON默认使用UTF-8编码，可以有效避免编码问题：

import execjs
import json

js_code = '''
function processData(data) {
    // 解析JSON格式的入参
    var obj = JSON.parse(data);
    obj.message = "处理完成：" + obj.content;
    // 返回JSON格式的字符串
    return JSON.stringify(obj);
}
'''

ctx = execjs.compile(js_code)

# 构造包含中文的参数，序列化为JSON字符串
param_obj = {"content": "测试中文内容"}
json_param = json.dumps(param_obj, ensure_ascii=False)

# 调用JS函数，传递JSON字符串
json_result = ctx.call("processData", json_param)

# 解析返回的JSON结果
result_obj = json.loads(json_result)
print(result_obj["message"])

方案三：更换更适配的调用库

如果PyExecJS频繁出现编码问题，可以更换为PyMiniRacer等基于V8引擎的调用库，这类库对Unicode的支持更完善：

from py_mini_racer import MiniRacer

# 初始化V8上下文
ctx = MiniRacer()

# 定义JS函数
js_func = '''
function add(a, b) {
    return a + b + "，附加中文内容";
}
'''

# 执行JS函数，传递中文参数
ctx.eval(js_func)
result = ctx.call("add", 1, 2)
print(result)

预防编码问题的建议

• 所有涉及Python和JS交互的字符串，尽量统一使用UTF-8编码，避免混合使用GBK、ASCII等编码。
• 传递复杂数据时优先使用JSON格式，减少直接传递原始字符串带来的编码风险。
• 在程序入口处可以主动检查系统默认编码，确保编码环境符合预期。
• 对调用JS函数的逻辑添加异常捕获，出现编码错误时及时打印相关参数和编码信息，方便排查问题。

PythonJS函数调用UnicodeEncodeError编码处理修改时间：2026-06-02 22:52:35