Lua 5.4中C读取数组式Table时索引返回nil问题及求解

问题现象 #

在Lua 5.4环境下（基于ESP-IDF），编写C注册函数接收Lua数组式Table时，能通过lua_rawlen正确获取表长度，但调用lua_rawgeti读取索引时，返回值始终为nil，最终转换后的C数组全为0。但使用lua_next迭代表却能正常读取所有元素。

相关代码 #

初始C代码（lua_rawgeti版本）

static int myFunction(lua_State *L)
{
  uint16 targetAddress = lua_tointeger(L, 1);

  if (lua_istable(L, 2) != 0)
  {
      unsigned int userDataSize = lua_rawlen(L, 2);
      ESP_LOGE(TAG, "length: %d", userDataSize);

      uint8_t *userData = (uint8_t *)malloc(userDataSize * sizeof(uint8_t));
      if (!userData)
      {
          ESP_LOGE(TAG, "GenericRequest Failed to allocate memory");
      }

      for (unsigned int i = 0; i < userDataSize; i++)
      {
              lua_rawgeti(L, 2, i + 1); // Lua使用1-based索引
              ESP_LOGE(TAG, "type %s", luaL_typename(L, -1));
              ESP_LOGI(TAG, "Val: %f", lua_tonumber(L, -1));
              userData[i] = (uint8_t)lua_tonumber(L, -1);
              ESP_LOGI(TAG, "%d: %d", i, userData[i]);
              lua_pop(L, 1); // 弹出栈顶值
      }

      ESP_LOGI(TAG, "TA: 0x%X data:", targetAddress);
      ESP_LOG_BUFFER_HEX(TAG, userData, userDataSize);
      free(userData);
  }
  else
  {
      ESP_LOGE(TAG, "Argument #2 expected table");
  }
  return 0;
}

对应Lua脚本

print("Hello from Lua") 
mylib.myFunction(0xA98, {1, 2, 3, 4, 5})

正常运行的lua_next版本C代码

uint16 targetAddress = lua_tointeger(L, 1);
printf("TA: 0x%X \n", targetAddress);

uint8_t idx_table = 2;
if (!lua_istable(L, idx_table)) {
    printf("Not a table.\n");
    return 0;
}

lua_pushnil(L);
while (lua_next(L, idx_table) != 0) {
    if (lua_isinteger(L, -1)) {
        printf("Value: %d\n", lua_tointeger(L, -1));
    } else if (lua_isstring(L, -1)) {
        printf("Value: %s\n", lua_tostring(L, -1));
    }
    lua_pop(L, 1);
}
return 0;

问题原因排查 #

从现象来看，lua_rawlen能正确返回表长度5，说明Lua认为该表是合法的数组式表（整数键连续1-5），但lua_rawgeti无法读取对应键的值。可能的原因包括：

• 键类型不匹配：虽然Lua脚本中写的是{1,2,3,4,5}，但如果表的实际键是字符串类型（如"1"而非整数1），lua_rawgeti会无法读取（它仅识别整数键），但lua_next会遍历所有类型的键。可以通过在lua_next代码中打印键的类型来验证。
• Lua环境实现差异：部分嵌入式Lua环境（如ESP-IDF集成的Lua）可能对lua_rawgeti的实现有特殊处理，导致无法正确访问数组部分。此时可以尝试替换为lua_geti或lua_pushinteger + lua_rawget的组合。
• 栈操作隐含错误：虽然代码中看起来栈操作正确，但某些情况下定制Lua环境可能存在栈状态意外修改的问题，导致表的栈索引不再是2。可以在循环前打印lua_istable(L,2)的结果，确认表的位置未变化。

lua_rawgeti与lua_next的核心差异 #

解决方法 #

1. 验证键类型：修改lua_next代码，打印键的类型和值，确认表的键是否为整数：

while (lua_next(L, idx_table) != 0) {
    // 打印键信息
    if (lua_isinteger(L, -2)) {
        printf("Key: integer %lld\n", lua_tointeger(L, -2));
    } else if (lua_isstring(L, -2)) {
        printf("Key: string %s\n", lua_tostring(L, -2));
    }
    // 打印值信息
    if (lua_isinteger(L, -1)) {
        printf("Value: %lld\n", lua_tointeger(L, -1));
    }
    lua_pop(L, 1);
}

2. 替换读取方式：将lua_rawgeti替换为lua_pushinteger + lua_rawget的组合，确保键的类型正确：

for (unsigned int i = 0; i < userDataSize; i++)
{
    lua_pushinteger(L, i + 1);
    lua_rawget(L, 2);
    // 后续处理逻辑不变
    lua_pop(L,1);
}

3. 尝试lua_geti：如果环境中lua_rawgeti存在实现问题，替换为lua_geti（无元表时行为与lua_rawgeti一致）：

lua_geti(L, 2, i + 1);

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