Troubleshooting

This guide covers common issues you might encounter when deploying and running the AI SaaS Boilerplate, along with their solutions.

Troubleshooting Categories

Debugging Tools and Resources

Before diving into specific issues, familiarize yourself with these debugging tools:

1. CloudWatch Logs: For Lambda function logs
2. CloudFormation Console: For deployment issues
3. API Gateway Test Console: For testing API endpoints
4. Stripe Dashboard: For payment and webhook testing
5. Browser DevTools: For frontend debugging

Common Deployment Issues

Common Frontend Issues

Common Backend and Service Issues

AI Service-Specific Issues

Logs and Monitoring

CloudWatch Logs

To access Lambda function logs:

1. Go to the CloudWatch Console
2. Click "Log groups" in the left sidebar
3. Find the log group for your function (usually /aws/lambda/your-function-name)
4. Click on the log group and then on the most recent log stream

API Gateway Logs

To enable and view API Gateway logs:

1. Go to the API Gateway Console
2. Select your API
3. Click "Stages" and select your stage
4. Under "Logs/Tracing", enable CloudWatch logs
5. View the logs in CloudWatch under the log group /aws/apigateway/your-api-id

Amplify Build Logs

To view frontend build logs:

1. Go to the Amplify Console
2. Select your application
3. Click on the branch
4. Click "Build logs" to see the most recent build

Getting Help

If you've tried the solutions above and are still experiencing issues:

1. Check for similar issues in the GitHub repository
2. Search for error messages in AWS documentation or forums
3. Consider reaching out to the community or the boilerplate author

Next Steps

For more detailed troubleshooting information, explore these specific guides:

• Deployment Issues
• Common Frontend Issues
• Authentication Issues
• Payment Issues
• AI Service Issues