Smartsheet API Python更新列时出现间歇性500 4004错误求助

近期用Python为客户开发自动化功能：客户通过表单提交新活动名称，脚本从指定工作表拉取数据，动态更新另一工作表的下拉列选项。脚本在Jupyter Notebook中全天运行无异常，但设置为Cron定时任务时，间歇性出现500 4004错误。代码使用update_column而非update_rows，调整Cron执行频率后问题仍未改善。

运行脚本 #

import smartsheet
import os

# 设置访问令牌到环境变量
os.environ['SMARTSHEET_ACCESS_TOKEN'] = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'

# 初始化Smartsheet模块
smart = smartsheet.Smartsheet()

# 获取接收新下拉选项的主工作表
# 定义工作表ID
############################## 下方插入工作表ID #################################
main_sheet = smart.Sheets.get_sheet(XXXXXXXXXXXXXXXX)
sheet_id = main_sheet.id

# 定义主工作表的下拉列序号（从零开始计数）
# 下方插入从零开始的列序号 #################################
pick_col = 6

# 定义下拉列的ID
col = main_sheet.columns[pick_col].id

##
## 从选项工作表拉取选项
##

# 获取包含新下拉选项的工作表
opt_sheet = smart.Sheets.get_sheet(XXXXXXXXXXXXXXXX)
opt_ID = opt_sheet.id

usda_opt = smart.Sheets.get_sheet(opt_ID, column_ids = opt_sheet.columns[0].id)

# 定义FOR循环的行数范围
num_rows1 = usda_opt.total_row_count

# 抓取下拉选项列的所有值，遇到空值跳过，确保只包含有效选项
# 注意：根据你的工作表修改单元格下标（从零开始）
new_options = []

for i in range(num_rows1):
    if opt_sheet.rows[i].cells[0].value == None:
        pass
    else:
        new_options.append(opt_sheet.rows[i].cells[0].value)

# 构建包含新选项的列对象
col_list = smart.models.Column({
    'title':main_sheet.columns[pick_col].title,
    'type':'PICKLIST',
    'options': new_options,
    'index': pick_col
})

# 发送更新请求，更新下拉列选项
updated_col = smart.Sheets.update_column(sheet_id, col, col_list)

错误分析 #

Smartsheet的4004错误码代表无效的列ID，结合场景来看，间歇性出现的原因可能有以下几点：

• 执行环境差异：Cron的执行环境与Jupyter不同，环境变量加载不完整，导致Smartsheet访问令牌失效，间接引发列ID验证失败；或者Cron使用的Python环境与Jupyter不一致，依赖包版本差异导致API请求处理异常。
• 网络波动：Cron执行时服务器网络不稳定，导致API请求超时、响应不完整，使得脚本解析到无效的列ID或请求被服务器异常处理。
• API请求并发冲突：表单提交操作与Cron任务同时对工作表进行读写，导致脚本获取的列ID临时失效（比如工作表结构被临时修改后恢复）。
• 代码潜在问题：脚本中重复调用get_sheet获取选项工作表（opt_sheet和usda_opt），可能因缓存或API返回数据不一致，导致后续遍历行时获取到错误数据，最终构造的列对象不符合要求引发错误。

解决思路 #

1. 统一执行环境：

   • 不在代码中硬编码设置环境变量，改为在Cron任务中先加载系统环境（比如source ~/.bash_profile && python3 /path/to/script.py），或者直接在脚本中从配置文件读取访问令牌。
   • 确保Cron使用的Python环境与Jupyter一致，通过which python3确认路径，并在Cron命令中指定完整Python路径。

2. 添加重试机制：

   • 对Smartsheet的API请求（get_sheet、update_column）添加重试逻辑，处理临时网络错误或服务器异常。例如使用tenacity库：

     from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type
     
     @retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, min=2, max=10), retry=retry_if_exception_type(Exception))
     def get_sheet_retry(smart, sheet_id):
         return smart.Sheets.get_sheet(sheet_id)
     

   • 调用API时捕获错误，记录详细日志后重试。

3. 优化代码减少API请求：

   • 删除冗余的usda_opt = smart.Sheets.get_sheet(opt_ID, column_ids = opt_sheet.columns[0].id)，直接用opt_sheet.total_row_count获取行数，减少一次API调用，降低出错概率。
   • 在构造列对象前，验证new_options非空，避免因空选项引发更新错误。

4. 增加错误日志：

   • 在脚本中添加日志模块，记录每次执行的时间、工作表ID、列ID、new_options内容，以及错误的堆栈信息。例如：

     import logging
     logging.basicConfig(filename='/path/to/script.log', level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
     

   • 执行失败时将错误信息写入日志，方便定位具体触发错误的场景。

5. 验证列ID有效性：

   • 在调用update_column前，再次确认列ID存在于目标工作表中，避免使用无效ID：

     column_exists = any(c.id == col for c in main_sheet.columns)
     if not column_exists:
         logging.error(f"Column ID {col} not found in main sheet {sheet_id}")
         exit(1)
     

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