SST项目中Prisma客户端打包问题的分析与解决方案

问题背景

在SST项目中使用Prisma ORM时，特别是在版本3.3.16之后，开发者遇到了一个常见的打包问题。当Lambda函数运行时，系统会报错提示无法找到Prisma查询引擎，错误信息明确指出运行时无法定位"rhel-openssl-3.0.x"的Query Engine。

问题根源分析

经过深入调查，发现问题主要出现在以下几个方面：

1. 路径处理问题：SST在3.3.16版本后对文件复制逻辑进行了修改，导致包含点号(.)的路径（特别是.prisma目录）无法被正确处理。

2. Monorepo结构影响：在Monorepo项目中，Prisma客户端通常位于子包中，这使得文件路径更加复杂，加剧了问题的出现。

3. 版本兼容性：这个问题在Prisma 5.22.0和6.0.1版本中都存在，说明与Prisma版本关系不大，主要是SST的打包机制变化导致的。

解决方案

临时解决方案

对于急需解决问题的开发者，可以采取以下临时措施：

1. 降级SST版本：回退到3.3.14版本可以暂时解决问题。

2. 手动指定Prisma输出路径：修改schema.prisma文件，将client输出路径从默认的".prisma"改为其他不含点号的路径。

长期解决方案

1. 修改Prisma客户端输出路径： 在schema.prisma中添加配置：

   output = "generated"
   

   然后在SST配置中明确指定复制路径：

   copyFiles: {
     from: 'path/to/generated/libquery_engine-rhel-openssl-3.0.x.so.node',
     to: 'prisma/generated/libquery_engine-rhel-openssl-3.0.x.so.node',
   }
   

2. 使用Lambda Layer： 创建一个专门的Lambda Layer来包含Prisma客户端文件，这可以绕过SST的打包限制。

3. 调整文件复制路径： 避免在目标路径中使用".prisma"这样的点号开头的目录名，可以改为：

   {
     from: 'node_modules/.prisma/client/libquery_engine-rhel-openssl-3.0.x.so.node',
     to: 'node_modules/prisma/libquery_engine-rhel-openssl-3.0.x.so.node',
   }
   

最佳实践建议

1. 对于Monorepo项目，建议将Prisma配置放在项目根目录，而不是子包中，这可以简化路径处理。

2. 在SST配置中，明确指定所有需要复制的Prisma引擎文件，而不是依赖自动发现机制。

3. 考虑使用环境变量PRISMA_QUERY_ENGINE_LIBRARY来明确指定引擎路径，特别是在使用Lambda Layer方案时。

4. 保持SST和Prisma版本的更新，并密切关注官方文档中的相关变更说明。

总结

这个问题本质上是SST打包机制与Prisma客户端特殊文件结构之间的兼容性问题。通过调整文件路径策略或使用Lambda Layer，开发者可以有效地解决这个问题。随着SST项目的持续发展，这个问题有望在未来的版本中得到根本性解决。在此期间，开发者可以根据项目实际情况选择最适合的解决方案。