Python打开日志文件提示非UTF-8有效，配置编码仍无效求解决方案

问题产生原因 #

• Python版本兼容问题：logging.basicConfig的encoding参数仅在Python 3.9及以上版本生效，如果使用3.8及更低版本，该配置不会生效，日志文件还是会用系统默认编码写入。
• 旧日志文件残留：原有的logEL.log文件中已经存在非UTF-8编码的内容，哪怕新配置生效，旧内容仍然会导致打开时报错。
• 日志输出内容本身存在非法编码：如果写入日志的内容包含未正确解码的bytes类型数据、或者其他编码格式的字符串，哪怕指定了UTF-8写入，也会生成不符合UTF-8规范的字节内容。
• 日志读取工具编码设置错误：部分工具（比如Windows默认记事本）会默认用GBK等系统编码打开文件，哪怕日志本身是UTF-8编码也会报错。

解决方案 #

1. 首先删除原有残留的日志文件/home/pi/Desktop/logEL.log，避免旧内容干扰测试。
2. 优先使用手动添加FileHandler的配置方式（兼容所有Python3版本），同时添加errors参数处理编码异常，示例配置如下：

import logging

root_logger = logging.getLogger()
# 清空原有默认处理器，避免重复输出
for handler in root_logger.handlers[:]:
    root_logger.removeHandler(handler)
root_logger.setLevel(logging.DEBUG)
# 新增errors='replace'参数，无法用UTF-8编码的字符会自动替换为�，避免生成非法字节
handler = logging.FileHandler('/home/pi/Desktop/logEL.log', 'a', 'utf-8', errors='replace')
formatter = logging.Formatter('%(asctime)s - %(message)s')
handler.setFormatter(formatter)
root_logger.addHandler(handler)

3. 输出日志前统一处理内容编码：不要直接将bytes类型数据传入日志方法，若内容来自其他编码的数据源，提前解码为Python str类型，无法确定编码时可使用errors='replace'处理解码异常：

# 示例：处理不确定编码的内容
raw_content = b'\xc4\xe3\xba\xc3' # GBK编码的“你好”
log_content = raw_content.decode('gbk', errors='replace')
logging.info(log_content)

4. 打开日志文件时，确认读取工具的编码设置为UTF-8，例如VS Code可点击右下角编码选择栏，指定以UTF-8格式重新打开文件。

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