@@ -78,3 +78,59 @@ Translations
7878* [ Turkish] ( https://github.com/sqlmapproject/sqlmap/blob/master/doc/translations/README-tr-TR.md )
7979* [ Ukrainian] ( https://github.com/sqlmapproject/sqlmap/blob/master/doc/translations/README-uk-UA.md )
8080* [ Vietnamese] ( https://github.com/sqlmapproject/sqlmap/blob/master/doc/translations/README-vi-VN.md )
81+
82+ ## Troubleshooting
83+
84+ This section helps users resolve common issues encountered while using sqlmap.
85+
86+ ---
87+
88+ ### Missing mandatory option error
89+ If you run sqlmap without specifying a target, you may see:
90+ missing a mandatory option (-u, -d, -l, -m, -r, -g, -c, etc.)
91+
92+ Solution:
93+ Always specify a valid target URL:
94+
95+ python sqlmap.py -u "http://example.com/page.php?id=1 "
96+
97+ ---
98+
99+ ### Connection problems
100+ If sqlmap cannot connect to the target URL:
101+ - Ensure the website is reachable in a browser
102+ - Try using a different User-Agent:
103+ --random-agent
104+ - Check your internet connection or firewall restrictions
105+
106+ ---
107+
108+ ### Injection not detected (false negative)
109+ If sqlmap does not detect SQL injection:
110+ - Increase testing intensity:
111+ --level=5 --risk=3
112+
113+ - Try all techniques:
114+
115+ --technique=BEUSTQ
116+
117+ - Test specific parameter manually using ` -p `
118+
119+ ---
120+
121+ ### WAF / Firewall blocking requests
122+ Some websites may block sqlmap requests.
123+
124+ Possible solutions:
125+ - Use random User-Agent:
126+ --random-agent
127+ - Add delay between requests:
128+ --delay=2
129+ - Use tamper scripts to bypass filtering:
130+ --tamper=space2comment
131+ ---
132+ ### General tip
133+ For better results, always ensure:
134+ - Target is reachable
135+ - Correct parameter is provided
136+ - Proper technique selection is used
0 commit comments