ASP.NET Web API本地正常，部署至AWS Lambda后报SqlException

以下是针对你遇到的问题（本地正常运行、Lambda部署后抛出SqlException）的常见原因及解决方法：

• VPC网络访问限制
  Lambda默认部署在公共网络环境，而AWS RDS通常配置在VPC私有子网内。若未将Lambda加入RDS所在的VPC，或VPC安全组规则未开放对应权限，Lambda将无法建立数据库连接。
  解决：进入Lambda控制台的「配置-VPC」页面，将Lambda配置到RDS所在的VPC及子网；同时在RDS的安全组入站规则中，添加Lambda安全组的访问权限（端口对应数据库类型：MySQL用3306，SQL Server用1433等）。

• 连接字符串配置错误
  本地使用的连接字符串可能不适用于Lambda环境：比如用了localhost/内网IP，未使用RDS的完整端点地址；或环境变量未正确传递连接参数；部分数据库驱动需强制SSL（如RDS MySQL默认要求SSL），但连接字符串未指定SslMode=Required。
  解决：在Lambda的环境变量中配置正确的连接字符串，Server字段填写RDS的完整端点（格式如xxx.rds.amazonaws.com），验证账号密码、数据库名称无误；根据数据库类型添加必要的SSL参数。

• Lambda执行角色权限不足
  若使用IAM认证连接RDS，Lambda执行角色需具备rds-db:connect权限；即使使用密码认证，Lambda在VPC内运行时也需要ec2:CreateNetworkInterface、ec2:DescribeNetworkInterfaces等VPC相关权限，否则无法创建网络接口连接RDS。
  解决：在IAM控制台为Lambda执行角色添加对应权限策略，或直接使用AWS托管的AWSLambdaVPCAccessExecutionRole策略。

• Lambda资源与超时限制
  Lambda默认执行超时为3秒，若数据库连接或查询耗时超过该时间会触发超时错误；同时内存配置过低会影响网络性能，间接导致连接失败。
  解决：在Lambda配置中调高超时时间（建议先设为10秒测试），同时适当提升内存配置（如256MB及以上）。

• 依赖包或运行时兼容性问题
  本地使用的.NET版本与Lambda配置的运行时版本不一致（如本地用.NET 6，Lambda选.NET 5），或数据库驱动包未正确打包到部署文件中，会导致Lambda环境缺失必要的驱动组件，触发SqlException。
  解决：确认Lambda运行时版本与本地开发环境一致；重新打包部署包，确保所有NuGet依赖（如MySqlConnector、Microsoft.Data.SqlClient）都包含在部署文件内。

• 系统依赖缺失
  部分数据库驱动依赖系统级库（如SQL Server驱动依赖msodbcsql17），而Lambda的Amazon Linux 2运行环境默认未安装这些库。
  解决：将所需系统库打包为Lambda层，或在部署时通过自定义运行时包含依赖组件。

快速排查步骤 #

1. 查看CloudWatch日志：在Lambda控制台的「监控-日志」中查看完整错误堆栈，获取SqlException的详细信息（Api Gateway返回的信息通常不完整）。
2. 测试连通性：在VPC内创建临时EC2实例，使用相同的连接字符串测试RDS连接，验证数据库本身是否可访问。
3. 打印连接参数：在Lambda代码中临时输出连接字符串（注意隐藏敏感信息），确认环境变量传递的参数正确。

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