Troubleshooting
Solutions to common nopCommerce deployment issues.
Installation Issues
Database Connection Failed
Symptoms: Cannot connect to database during installation
Solutions:
- Verify database server is running
- Check connection string format
- Ensure database user has proper permissions
- For SQL Server, enable TCP/IP in Configuration Manager
500 Internal Server Error
Check:
- Enable detailed errors in
web.config:
xml
<aspNetCore stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" />- Review logs in
.\logs\folder - Check Windows Event Viewer
Runtime Issues
Slow Page Loads
- Enable caching in Admin settings
- Check database query performance
- Review server resources (CPU, RAM)
- Consider adding CDN for static files
Out of Memory
- Increase application pool memory limit
- Review scheduled tasks frequency
- Check for memory leaks in custom plugins
SSL Certificate Errors
- Verify certificate is valid and not expired
- Check certificate chain is complete
- Ensure intermediate certificates installed
Common Error Codes
| Error | Cause | Solution |
|---|---|---|
| 500.19 | Config error | Check web.config syntax |
| 502.5 | App startup failure | Check logs, verify .NET installed |
| 503 | App pool stopped | Restart app pool, check events |
Getting Help
- Check nopCommerce logs:
App_Data\Logs\ - Review nopCommerce Forums
- Submit GitHub issues for bugs